Implement survey wait period (seenSurveyWaitPeriodInDays) for React Native

🚨 IMPORTANT

This issue is likely user-facing in the main PostHog app, see surveyVersionRequirements.ts. If you delete or close this issue, be sure to update the version requirements list here.

Summary

The posthog-react-native SDK does not implement the survey wait period (seenSurveyWaitPeriodInDays) filtering logic. The code is commented out in packages/react-native/src/surveys/getActiveMatchingSurveys.ts (lines 47-52).

Current State

• The seenSurveyWaitPeriodInDays field is available on the Survey type (from @posthog/core)
• The filtering logic in getActiveMatchingSurveys.ts has the wait period check commented out
• No lastSeenSurveyDate storage is implemented

Expected Behavior

When survey.conditions.seenSurveyWaitPeriodInDays is set, the SDK should:

1. Store the date when any survey was last shown to the user
2. During getActiveMatchingSurveys(), skip surveys if the wait period has not yet elapsed since the last seen survey date

Reference Implementation

See posthog-js browser: packages/browser/src/extensions/surveys/surveys-extension-utils.tsx — hasWaitPeriodPassed() function and LAST_SEEN_SURVEY_DATE_KEY storage.
See also: packages/browser/src/extensions/utils/matcher-utils.ts — hasPeriodPassed() utility.

Tracking

This is tracked in the survey SDK feature parity issue: https://github.com/PostHog/posthog/issues/45658

This issue was generated by Claude using the /survey-sdk-audit skill.

Read packages/react-native/src/surveys/getActiveMatchingSurveys.ts, especially the commented wait-period logic, then compare it with hasWaitPeriodPassed() and LAST_SEEN_SURVEY_DATE_KEY in packages/browser/src/extensions/surveys/surveys-extension-utils.tsx and hasPeriodPassed() in packages/browser/src/extensions/utils/matcher-utils.ts. Done means React Native persists the date any survey was shown and getActiveMatchingSurveys() skips surveys until the configured wait period has elapsed.