Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
39 commits
Select commit Hold shift + click to select a range
1f3982e
chore!: adopt posthog-android 4.0, core 7.0 and posthog-ios 4.0
turnipdabeets Oct 28, 2026
03671ac
chore: mark the native 4.0 changeset as breaking
turnipdabeets Oct 29, 2026
2ab12cc
chore!: remove SessionRecordingConfig.screenshot (#109)
turnipdabeets Nov 3, 2026
84f670a
fix(apple): report posthog-kmp through the native SDK name setter
turnipdabeets Nov 4, 2026
8b3269a
test: match the getFeatureFlag call to posthog-android 4.0
turnipdabeets Nov 4, 2026
1871584
docs: list the native 4.0 behavior changes KMP apps inherit
turnipdabeets Nov 4, 2026
9c23326
docs: say the replay screenshot change comes from the native 4.0 SDKs
turnipdabeets Nov 4, 2026
b5e6616
chore(sample): regenerate the iOS linkage package for posthog-ios 4.0.0
turnipdabeets Nov 5, 2026
45e1c42
docs: add a 0.10 to 0.11 migration guide and complete the 4.0 changeset
turnipdabeets Nov 5, 2026
87763cb
docs(apple): say what the native SDK name setter feeds
turnipdabeets Nov 5, 2026
749bd17
feat(replay): add throttleDelayMs and deprecate debouncerDelayMs
turnipdabeets Nov 5, 2026
dc8d966
docs: say a full queue evicts capture v1 events on a 404
turnipdabeets Nov 6, 2026
cf7854b
docs: warn that older self-hosted proxy recipes strip Authorization
turnipdabeets Nov 6, 2026
481ea99
feat(flags)!: match the native 4.0 feature flag API
turnipdabeets Nov 6, 2026
4b37ea3
docs: say the feature flag changes also reach JavaScript and Wasm
turnipdabeets Nov 6, 2026
35a5624
docs: say an empty variant is left out of $active_feature_flags
turnipdabeets Nov 6, 2026
43b3f75
docs: mark the debouncerDelayMs copy() change as breaking and fix fla…
turnipdabeets Nov 8, 2026
0769afd
feat: add PostHog.setAppLanguage() and send $locale as BCP 47 on JVM …
turnipdabeets Nov 9, 2026
4cbb961
docs: cover recompiling, proxy headers and new APIs in the 0.11 migra…
turnipdabeets Nov 9, 2026
e7836ae
docs: say JavaScript and Wasm still return a non-JSON flag payload as…
turnipdabeets Nov 9, 2026
d1ee1c2
docs: cover native 4.0 behaviour changes in the 0.11 migration guide
turnipdabeets Nov 9, 2026
92fccbc
chore: address #108 review follow-ups (web errorsLoading replay, befo…
turnipdabeets Nov 10, 2026
30e4d2c
Merge remote-tracking branch 'origin/main' into chore/adopt-native-4.0
turnipdabeets Nov 10, 2026
27c897e
docs: list every 0.11 breaking change in the changeset and scope setA…
turnipdabeets Nov 10, 2026
4821ed0
docs: say a registered personless setting drops identity events on na…
turnipdabeets Nov 10, 2026
e8c1951
fix: skip flag listeners unsubscribed during delivery on JS and Wasm
turnipdabeets Nov 10, 2026
0f8352a
fix: keep setGroupPropertiesForFlags from turning on person processin…
turnipdabeets Nov 10, 2026
9a29b5b
docs: say when the reload callback doesn't run on JS and Wasm
turnipdabeets Nov 10, 2026
b6b4b21
docs: correct person-processing and session ID notes in the 0.11 migr…
turnipdabeets Nov 10, 2026
c41f700
Merge remote-tracking branch 'origin/main' into merge-main/adopt-nati…
turnipdabeets Nov 12, 2026
922d69e
feat: add event options, registerOptions and captureAi (#119)
turnipdabeets Nov 13, 2026
9f7a5dd
Merge remote-tracking branch 'origin/main' into chore/adopt-native-4.0
turnipdabeets Nov 13, 2026
7304360
docs: map the 0.11 PostHog members in the SDK reference
turnipdabeets Nov 13, 2026
1a1205c
docs: say iOS replay records Compose Multiplatform screens unmasked
turnipdabeets Nov 13, 2026
c8f5f10
feat: add SessionRecordingConfig.iosCaptureMethod
turnipdabeets Nov 16, 2026
d79edac
docs: describe iOS Compose Multiplatform screens as recorded fully ma…
turnipdabeets Nov 16, 2026
a29b9e7
Merge main (#125 surveys, release 0.11.0) into chore/adopt-native-4.0
turnipdabeets Nov 16, 2026
ecc9465
docs: renumber the migration guide for 0.12
turnipdabeets Nov 16, 2026
12e6802
fix(apple): keep inAppByDefault true when errorTracking isn't set
turnipdabeets Nov 17, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 24 additions & 0 deletions .changeset/adopt-native-4-0.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
---
"posthog-kmp": minor
---

- See the [0.11 to 0.12 migration guide](https://github.com/PostHog/posthog-kmp/blob/main/MIGRATION.md) for upgrade steps
- **Breaking:** upgrade to posthog-android 4.0, the JVM core 7.0 and posthog-ios 4.0
- **Breaking:** require Xcode 26 or later to build iOS and macOS apps, and macOS 11 or later
- **Breaking:** require recompiling libraries built against posthog-kmp 0.11 or earlier, which fail on Android and JVM with `NoSuchMethodError`
- **Breaking:** require `posthog-server` 2.25.0 or later, and `posthog-android` 4.0.0 declared alongside `posthog-android-surveys-compose`, in the same Android or JVM build
- **Breaking:** send events to capture v1 (`/i/v1/analytics/events`) on Android, JVM, iOS and macOS β€” make sure your reverse proxy or self-hosted instance serves that path; only 307 and 308 redirects to the same origin are followed
- **Breaking:** retry a capture 404 until the host serves capture v1, keeping events only until a full queue evicts them, stop retrying 3xx responses, and cap a request at about 5 MiB, on Android, JVM, iOS and macOS
- **Breaking:** disable the SDK at setup when `projectToken` is a personal API key (`phx_...`) on Android, JVM, iOS and macOS
- **Breaking:** drop events with an empty name or with a distinct ID that `beforeSend` blanks, and let PostHog drop events whose name or distinct ID is over 200 bytes, on Android, JVM, iOS and macOS
- **Breaking:** mark personless events with a capture option instead of a `$process_person_profile` property, on Android, JVM, iOS and macOS β€” `beforeSend` reads and changes it through `PostHogEvent.options`
- **Breaking:** leave out `null` values in nested maps on iOS and macOS, and keep `null` list elements in place instead of removing them on Android and JVM
- **Breaking:** always send `$sdk_debug_replay_capture_mode` as `screenshot` on Android and iOS
- **Breaking:** leave out query parameters whose name starts with `$` from `Deep Link Opened` on Android
- **Breaking:** leave out `$feature_flag_response` on `$feature_flag_called` for a missing flag on Android, JVM, iOS and macOS β€” filter on *is not set* instead of `""` or `false`
- **Breaking:** return a `null` `FeatureFlagResult.payload` for a payload that isn't valid JSON on Android, JVM, iOS and macOS
- **Breaking:** let `register()` super properties override properties the SDK sets, such as `$os_name`, on Android, JVM, iOS and macOS
- **Breaking:** apply a registered `$process_person_profile = false` to every event except those `identify()`, `alias()`, `group()` and `setPersonProperties()` send, on Android, JVM, iOS and macOS β€” use `personProfiles` instead
- **Breaking:** change `$locale` to the device's preferred language and region on Android, iOS and macOS, and to a BCP 47 tag that keeps the script, such as `zh-Hant-TW`, on JVM
- **Breaking:** remove the `version` and `build` properties from `Application Installed`, `Application Updated` and `Application Opened` on iOS and macOS β€” use `$app_version` and `$app_build`
- Add the `$app_language` property with the language the app displays on Android 13+, iOS and macOS, and `PostHog.setAppLanguage()` to set it on every platform except JavaScript and Wasm
7 changes: 7 additions & 0 deletions .changeset/drop-replay-screenshot-option.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"posthog-kmp": minor
---

- **Breaking:** remove `SessionRecordingConfig.screenshot`, because posthog-android 4.0 and posthog-ios 4.0 removed wireframe replay β€” apps that kept the default `false` now record masked screenshots, including Compose screens on Android, so mask custom-drawn content such as maps or video, or turn replay off
- **Breaking:** record Compose Multiplatform screens on iOS, which 0.11 didn't, fully masked while `maskAllTextInputs` or `maskAllImages` is on
- **Breaking:** remove the JVM `SessionRecordingConfig` constructor and `copy` overloads that took `screenshot`
9 changes: 9 additions & 0 deletions .changeset/feature-flags-native-parity.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
---
"posthog-kmp": minor
---

- **Breaking:** pass `PostHogFeatureFlagsLoaded` with the loaded flags and `errorsLoading` to the `reloadFeatureFlags()` callback, and call it with `errorsLoading = true` before `setup()` on every platform
- **Breaking:** treat a flag whose variant is an empty string as disabled in `isFeatureEnabled()`, `FeatureFlagResult.enabled`, `getAllFeatureFlags()` and `$active_feature_flags` on every platform
- Add `PostHog.onFeatureFlags()` to listen for feature flag loads, returning a `PostHogFeatureFlagsSubscription`
- Add `setPersonPropertiesForFlags()`, `resetPersonPropertiesForFlags()`, `setGroupPropertiesForFlags()` and `resetGroupPropertiesForFlags()`
- Add `PostHogConfig.evaluationContexts` to evaluate only the feature flags tagged with those contexts
5 changes: 5 additions & 0 deletions .changeset/ios-replay-capture-method.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"posthog-kmp": minor
---

- Add `SessionRecordingConfig.iosCaptureMethod` (`STANDARD`, `BACKGROUND` or experimental `GPU`) to choose how iOS captures session replay screenshots
7 changes: 7 additions & 0 deletions .changeset/replay-throttle-delay.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
---
"posthog-kmp": minor
---

- **Breaking:** remove the `debouncerDelayMs` parameter from `SessionRecordingConfig.copy()` β€” pass `throttleDelayMs` instead
- Add `SessionRecordingConfig.throttleDelayMs`, the minimum delay between session replay snapshots, and apply it on iOS as well as Android
- Deprecate `SessionRecordingConfig.debouncerDelayMs` in favor of `throttleDelayMs`
11 changes: 11 additions & 0 deletions .changeset/v1-event-options.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
"posthog-kmp": minor
---

- Add event options, set per event as a map through `CaptureOptions.eventOptions` and a new `eventOptions` parameter on `screen()`, `identify()`, `alias()`, `group()`, `setPersonProperties()` and `captureException()` β€” on JavaScript and Wasm they're sent as their legacy `$` properties on `capture()`, `screen()` and `captureException()` and dropped by the other calls
- Add `PostHogEventOptions` with the option keys `PROCESS_PERSON_PROFILE`, `COOKIELESS_MODE`, `DISABLE_SKEW_CORRECTION` and `PRODUCT_TOUR_ID`; other keys are sent as given on Android, JVM, iOS and macOS
- Add `PostHog.registerOptions()` and `PostHog.unregisterOptions()` to send event options with every later event
- Add `PostHogEvent.options` so `beforeSend` callbacks can read and change an event's options on Android, JVM, iOS and macOS
- Add `PostHog.captureAi()` to send AI observability events, such as `$ai_generation`, to PostHog's AI endpoint on Android, JVM, iOS and macOS, returning the event's UUID; it sends nothing on JavaScript and Wasm
- Add `PostHogConfig.captureAiCompression`, `captureAiMaxQueueSize`, `captureAiTimeout` and `captureAiMaxEventBytes` to configure `captureAi()` requests on Android, JVM, iOS and macOS
- Name the event and the exception type in the debug log when a `beforeSend` callback throws
Loading
Loading