[crisryantan]

Why

When pre-selection scans a form while a shopper is still typing an email address, keystroke input events can capture a partial address that differs from the completed email sent on the confirmation page, causing a cache key mismatch on the email attribute. Reading the field only after a trusted change event when the field is no longer focused (or on a checkout commit intent), and requiring a multi-character top-level domain, avoids capturing partial emails mid-typing.

Programme

Standalone change, no programme.

What changes

• recordShopperInput records an email candidate in shopperInputs on a trusted change event, removes it if a later input or other event fires before the next change, and removes an uncommitted candidate from touchedInputs on blur. A blur never marks a field finished, since a script can set the value silently first; only a trusted change does, and the listener still reads no value.
• Rokt-Kit listens for capture blur events alongside input and change only so a blur drops a field no change committed. A blur never flushes pending dispatches, since a script can set the value silently before it; a field committed while focused waits for the next trigger or checkout commit intent.
• isEmailInput skips document.activeElement, and scanFormEmails skips document.activeElement on background reads while reading a focused committed field on a checkout intent signal, counting an unsettled touched field toward the two-email rule when it is type="email", has autocomplete="email", is mid-edit after a committed change, or holds @ (testing a text field's value only for @), and reporting uncommitted_fill in describeMissingEmail.
• EMAIL_PATTERN requires a top-level domain of two or more ASCII letters, a punycode xn-- label, or two or more non-whitespace, non-separator Unicode characters.
• Unit and integration tests cover two-letter, punycode, internationalized, single-character, whitespace, and numeric TLDs, keystroke-only input events, re-editing a completed field and blurring without a change (including after a silent script write), focused inputs never flushing on blur (including after a silent script write) and firing on commit intent, unsettled second fields in the ambiguity check, and uncommitted_fill.

Linked work

• Standalone fix in the Rokt kit pre-selection form email reader.

Rollout

No flag. Rollback is a revert.

Risks

• A form email field is read on background scans only after change fires and the field is not focused, or while focused when checkout commit intent fires. A trusted change on an unfocused email field flushes pending pre-selection dispatches; a blur never does.

Who

Written by: an automated coding agent.
Checked: CI runs the kit's Vitest suite (mparticle-web-kit-tests) on this change. It was not run on the authoring machine.

Size

Hand-written: 4 files, 466 lines added and 71 removed.

[codecov]

Codecov Report

❌ Patch coverage is 98.70130% with 1 line in your changes missing coverage. Please review.
⚠️ Please upload report for BASE (v3-development@f39b38b). Learn more about missing BASE report.

Files with missing lines	Patch %	Lines
kits/rokt/src/preselection/preselection.ts	98.66%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@                Coverage Diff                @@
##             v3-development    #1778   +/-   ##
=================================================
  Coverage                  ?   64.20%           
=================================================
  Files                     ?       79           
  Lines                     ?    10722           
  Branches                  ?     3109           
=================================================
  Hits                      ?     6884           
  Misses                    ?     3514           
  Partials                  ?      324           

Flag	Coverage Δ
core	54.51% <ø> (?)
rokt-kit	92.59% <98.70%> (?)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[mattbodle]

Automated agent review; not an independent human approval.
Head 2ccf069.
A blur can flush a field value the change path would have ignored, and BrowserStack Beta Browsers Test is failing.

[mattbodle]

Automated agent review; not an independent human approval.
Head 612e4ee.
Not verified: Safari event order. This is not an approval because a blur with event.isTrusted true can still flush a script-set value.

[mattbodle]

Automated agent review; not an independent human approval.
Head e3bfb36. Moving focus after a script sets the value fires a trusted blur and no change, in Chrome, Firefox, and WebKit, and that blur still sends that value. Not an approval.
Kit Tests: Amplitude 8 is failing. Safari was not driven. The full kit suite was not run locally.

[mattbodle]

Automated agent review; not an independent human approval.
Head e3bfb36.
A trusted blur after a committed email sends a value a script wrote with no input event. The previous code does not flush on that blur.

[mattbodle]

Automated agent review; not an independent human approval.
Head 028da73.
A change while a field has focus, then a script sets another value, then blur, still sends that value. The previous code does not flush on that blur. BrowserStack Test fails an identity custom-device assertion on Firefox 51. Safari was not driven.

[mattbodle]

Automated agent review; not an independent human approval.
Head c10bc8f.
A focused commit does not flush, but the change fired when focus later leaves still sends a value written after that commit. The base sends the focused commit. Not an approval.

[mattbodle]

A change that fires after focus leaves still flushes the field's current value. A commit while the field is focused does not. A value written between them is what this change sends, where the base sends the focused commit.