Skip to content

feat(analytics-controller): optional skipUUIDv4Check on platform adapter#8543

Open
gauthierpetetin wants to merge 3 commits intomainfrom
feat/analytics-controller-skip-uuid-v4-check
Open

feat(analytics-controller): optional skipUUIDv4Check on platform adapter#8543
gauthierpetetin wants to merge 3 commits intomainfrom
feat/analytics-controller-skip-uuid-v4-check

Conversation

@gauthierpetetin
Copy link
Copy Markdown
Contributor

@gauthierpetetin gauthierpetetin commented Apr 21, 2026

Explanation

Allow non-UUIDv4 analyticsId when adapter.skipUUIDv4Check is true, as this is needed in Extension, where IDs are not UUIDv4.

References

NA

Checklist

  • I've updated the test suite for new or updated code as appropriate
  • I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
  • I've communicated my changes to consumers by updating changelogs for packages I've changed
  • [] I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them

Note

Medium Risk
Relaxes analyticsId validation when skipUUIDv4Check is enabled on the platform adapter, which could allow inconsistent identifiers if misused but remains opt-in and still rejects empty IDs.

Overview
Adds an optional skipUUIDv4Check flag to AnalyticsPlatformAdapter and threads it into AnalyticsController state validation so platforms can use non-UUIDv4 analyticsId values while still requiring a non-empty string.

Updates the state validator and expands unit tests (controller + validator) to cover the new bypass behavior, and documents the change in the package changelog.

Reviewed by Cursor Bugbot for commit 9f6e598. Bugbot is set up for automated code reviews on this repo. Configure here.

Allow non-UUIDv4 analyticsId when adapter.skipUUIDv4Check is true.
Tighten validateAnalyticsControllerState to a single guard. Add tests
and changelog entry.

Made-with: Cursor
Fix lint:misc --check (oxfmt) formatting in AnalyticsController and
analyticsControllerStateValidator tests.

Made-with: Cursor
Satisfy check-changelog by referencing the current pull request.

Made-with: Cursor
@gauthierpetetin gauthierpetetin marked this pull request as ready for review April 21, 2026 13:48
@gauthierpetetin gauthierpetetin requested review from a team as code owners April 21, 2026 13:48
@gauthierpetetin gauthierpetetin self-assigned this Apr 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant