feat(surveys): collect partial responses and resume unfinished surveys

.changeset/smooth-birds-cheat.md

@@ -0,0 +1,15 @@
+---
+"posthog": minor
+"posthog-android": minor
+"posthog-android-surveys-compose": minor
+---
+
+Support survey partial response collection. When enabled, submit cumulative answers after each question with a stable submission ID and completion status, matching posthog-js.
+
+Persist unfinished survey progress across app restarts and restore the submission ID, collected answers, and next question. Clear progress on completion, dismissal, SDK reset, and incompatible survey updates. The Compose renderer starts at the restored question.
+
+Keep unfinished surveys across Activity teardown, preserve unreadable progress during Direct Boot, and invalidate delayed responses on reset without mixing user identities.
+
+Discard visible, delayed, and retained Compose survey input on reset, while preserving fresh presentations and delegate reuse across SDK configurations.
+
+Preserve unfinished progress when startup has no cached survey configuration; confirmed empty survey lists still clear removed surveys.

.github/workflows/build.yml

@@ -53,6 +53,10 @@ jobs:
         if: needs.detect-markdown-only.outputs.markdown_only != 'true'
         run: make compile
 
+      - name: Test survey UI
+        if: needs.detect-markdown-only.outputs.markdown_only != 'true'
+        run: make testSurveyUI
+
       - name: Check release tasks and dependency locks
         if: needs.detect-markdown-only.outputs.markdown_only != 'true'
         run: make checkRelease

Makefile

@@ -1,4 +1,4 @@
-.PHONY: clean compile stop checkFormat format api dryRelease release testReport test testJava generateLintBaseLine checkRelease updateLocks
+.PHONY: clean compile stop checkFormat format api dryRelease release testReport test testJava testSurveyUI generateLintBaseLine checkRelease updateLocks
 
 clean:
 	./gradlew clean
@@ -67,6 +67,10 @@ test:
 testJava:
 	./gradlew :posthog:test
 
+# Mounted Compose tests use the debug-only test activity manifest, including on CI.
+testSurveyUI:
+	CI=false ./gradlew :posthog-android-surveys-compose:testDebugUnitTest
+
 generateLintBaseLine:
 	rm -f posthog-android/lint-baseline.xml
 	./gradlew lintDebug -Dlint.baselines.continue=true

posthog-android-surveys-compose/build.gradle.kts

@@ -29,6 +29,10 @@ android {
         }
     }
 
+    testOptions {
+        unitTests.isIncludeAndroidResources = true
+    }
+
     buildFeatures {
         compose = true
     }
@@ -89,6 +93,10 @@ dependencies {
     debugImplementation("androidx.compose.ui:ui-tooling")
 
     // tests
+    testImplementation("androidx.test.ext:junit:${PosthogBuildConfig.Dependencies.ANDROIDX_JUNIT}")
+    testImplementation("org.robolectric:robolectric:${PosthogBuildConfig.Dependencies.ROBOLECTRIC}")
+    testImplementation("androidx.compose.ui:ui-test-junit4")
+    debugImplementation("androidx.compose.ui:ui-test-manifest")
     testImplementation("junit:junit:${PosthogBuildConfig.Dependencies.ANDROIDX_JUNIT}")
     testImplementation("org.jetbrains.kotlin:kotlin-test-junit:${PosthogBuildConfig.Kotlin.KOTLIN}")
 }

posthog-android-surveys-compose/src/main/java/com/posthog/android/surveys/compose/PostHogSurveysComposeDelegate.kt

@@ -8,7 +8,10 @@ import com.posthog.surveys.OnPostHogSurveyClosed
 import com.posthog.surveys.OnPostHogSurveyResponse
 import com.posthog.surveys.OnPostHogSurveyShown
 import com.posthog.surveys.PostHogDisplaySurvey
-import com.posthog.surveys.PostHogSurveysDelegate
+import com.posthog.surveys.PostHogSurveyPresentation
+import com.posthog.surveys.PostHogSurveyPresentationSession
+import com.posthog.surveys.PostHogSurveysConfig
+import com.posthog.surveys.PostHogSurveysResetAwareDelegate
 
 /**
  * Default Compose-based UI for PostHog surveys on Android.
@@ -63,7 +66,7 @@ import com.posthog.surveys.PostHogSurveysDelegate
  * The constructor accepts any [Context] and resolves the [Application] from
  * it, so passing an activity context is safe.
  */
-public class PostHogSurveysComposeDelegate(context: Context) : PostHogSurveysDelegate {
+public class PostHogSurveysComposeDelegate(context: Context) : PostHogSurveysResetAwareDelegate {
     private val application: Application = context.applicationContext as Application
     private val activityProvider: ActivityProvider = ActivityProvider()
     private val host: PostHogSurveyHost = PostHogSurveyHost(activityProvider)
@@ -86,6 +89,30 @@ public class PostHogSurveysComposeDelegate(context: Context) : PostHogSurveysDel
         )
     }
 
+    override fun renderSurvey(
+        presentation: PostHogSurveyPresentation,
+        onSurveyShown: OnPostHogSurveyShown,
+        onSurveyResponse: OnPostHogSurveyResponse,
+        onSurveyClosed: OnPostHogSurveyClosed,
+    ) {
+        host.show(presentation, onSurveyShown, onSurveyResponse, onSurveyClosed)
+    }
+
+    override fun bindSurveySession(session: PostHogSurveyPresentationSession) {
+        host.bindSession(session)
+    }
+
+    override fun onSurveyReset(
+        resetGeneration: Long,
+        config: PostHogSurveysConfig,
+    ) {
+        host.onReset(resetGeneration, config)
+    }
+
+    override fun cleanupSurveys(session: PostHogSurveyPresentationSession) {
+        host.cleanup(session)
+    }
+
     override fun cleanupSurveys() {
         host.cleanup()
     }

posthog-android-surveys-compose/src/main/java/com/posthog/android/surveys/compose/internal/ActivityProvider.kt

@@ -25,7 +25,7 @@ internal class ActivityProvider : Application.ActivityLifecycleCallbacks {
 
     /**
      * Invoked on the main thread when an activity resumes, so a survey dropped
-     * for a configuration change can be re-presented on the recreated activity.
+     * during host teardown can be re-presented on the next foreground activity.
      */
     var onActivityResumedListener: ((Activity) -> Unit)? = null