Support filling a generated date of birth

noisysocks · claude · noisysocks · commit 641f8462fe48 · 2026-07-28T14:54:03.000+10:00
Adds a `$generated_dob$` fillForm element type that fills an
`&lt;input type="date"&gt;` with a random date of birth consistent with the age on
the extracted profile, resolved through the same lookup chain as every other
field.

Also replaces the real-looking street addresses in the broker-protection test
fixtures with obviously synthetic ones.

Co-Authored-By: Claude Opus 5 (1M context) &lt;noreply@anthropic.com&gt;
diff --git a/injected/integration-test/broker-protection-tests/broker-protection.spec.js b/injected/integration-test/broker-protection-tests/broker-protection.spec.js
@@ -441,9 +441,9 @@ test.describe('Broker Protection communications', () => {
                     name: 'John B Sample',
                     alternativeNames: [],
                     addresses: [
-                        { city: 'Acworth', state: 'GA', extras: { street: '1591 Oakmont Dr', zip: '30102' } },
+                        { city: 'Acworth', state: 'GA', extras: { street: '100 Sample Dr', zip: '30102' } },
                         { city: 'Dayton', state: 'OH', extras: { street: 'Po-Box 42', zip: '45402' } },
-                        { city: 'Franklin', state: 'TN', extras: { street: '250 Elm St', zip: '37064' } },
+                        { city: 'Franklin', state: 'TN', extras: { street: '250 Example St', zip: '37064' } },
                     ],
                     phoneNumbers: [],
                     relatives: [],
@@ -465,10 +465,10 @@ test.describe('Broker Protection communications', () => {
                     name: 'John Sample',
                     alternativeNames: [],
                     addresses: [
-                        { city: 'Baytown', state: 'TX', extras: { street: '2323 Bay Hill Dr', zip: '77523' } },
-                        { city: 'Baytown', state: 'TX', extras: { street: '1810 Bayou Breeze Dr', zip: '77523' } },
-                        { city: 'Livingston', state: 'TX', extras: { street: '197 Carlisle Rd', zip: '77351' } },
-                        { city: 'Livingston', state: 'TX', extras: { street: '455 Pine Grove Ln', zip: '77351' } },
+                        { city: 'Baytown', state: 'TX', extras: { street: '100 Sample Dr', zip: '77523' } },
+                        { city: 'Baytown', state: 'TX', extras: { street: '200 Sample Ct', zip: '77523' } },
+                        { city: 'Livingston', state: 'TX', extras: { street: '300 Example Rd', zip: '77351' } },
+                        { city: 'Livingston', state: 'TX', extras: { street: '400 Example Ln', zip: '77351' } },
                     ],
                     phoneNumbers: [],
                     relatives: [],
@@ -489,9 +489,9 @@ test.describe('Broker Protection communications', () => {
                     age: '40',
                     alternativeNames: [],
                     addresses: [
-                        { city: 'Baytown', state: 'TX', extras: { street: '2323 Bay Hill Dr', zip: '77523' } },
-                        { city: 'Livingston', state: 'TX', extras: { street: '197 Carlisle Rd', zip: '77351' } },
-                        { city: 'Livingston', state: 'TX', extras: { street: '455 Pine Grove Ln', zip: '77351' } },
+                        { city: 'Baytown', state: 'TX', extras: { street: '100 Sample Dr', zip: '77523' } },
+                        { city: 'Livingston', state: 'TX', extras: { street: '300 Example Rd', zip: '77351' } },
+                        { city: 'Livingston', state: 'TX', extras: { street: '400 Example Ln', zip: '77351' } },
                     ],
                     phoneNumbers: [],
                     relatives: [],
@@ -806,7 +806,7 @@ test.describe('Broker Protection communications', () => {
             await dbp.doesInputValueEqual('#FirstName', 'John');
             await dbp.doesInputValueEqual('#MiddleName', 'Andrew');
             await dbp.doesInputValueEqual('#LastName', 'Sample');
-            await dbp.doesInputValueEqual('#StreetAddress', '2323 Bay Hill Dr');
+            await dbp.doesInputValueEqual('#StreetAddress', '100 Sample Dr');
             await dbp.doesInputValueEqual('#City', 'Baytown');
             await dbp.doesInputValueEqual('#State', 'TX');
         });
@@ -818,7 +818,7 @@ test.describe('Broker Protection communications', () => {
             await dbp.receivesAction('fill-form-extras-address-selection.json');
             const response = await dbp.collector.waitForMessage('actionCompleted');
             dbp.isSuccessMessage(response);
-            await dbp.doesInputValueEqual('#StreetAddress', '197 Carlisle Rd');
+            await dbp.doesInputValueEqual('#StreetAddress', '300 Example Rd');
             await dbp.doesInputValueEqual('#City', 'Livingston');
             await dbp.doesInputValueEqual('#State', 'TX');
         });
@@ -830,7 +830,7 @@ test.describe('Broker Protection communications', () => {
             await dbp.receivesAction('fill-form-extras-no-user-profile.json');
             const response = await dbp.collector.waitForMessage('actionCompleted');
             dbp.isSuccessMessage(response);
-            await dbp.doesInputValueEqual('#StreetAddress', '2323 Bay Hill Dr');
+            await dbp.doesInputValueEqual('#StreetAddress', '100 Sample Dr');
             await dbp.doesInputValueEqual('#City', 'Baytown');
         });
 
@@ -846,6 +846,29 @@ test.describe('Broker Protection communications', () => {
             await dbp.doesInputValueEqual('#FirstName', 'John');
         });
 
+        test('fillForm generates a date of birth matching the extracted age', async ({ page }, workerInfo) => {
+            const dbp = BrokerProtectionPage.create(page, workerInfo.project.use);
+            await dbp.enabled();
+            await dbp.navigatesTo('opt-out-form.html');
+            await dbp.receivesAction('fill-form-generated-dob.json');
+            const response = await dbp.collector.waitForMessage('actionCompleted');
+            dbp.isSuccessMessage(response);
+            await dbp.isDateOfBirthForAge('#Dob', 51);
+            await dbp.doesInputValueEqual('#StreetAddress', '100 Sample Dr');
+            await dbp.doesInputValueEqual('#City', 'Baytown');
+            await dbp.doesInputValueEqual('#State', 'TX');
+        });
+
+        test('fillForm errors when a generated date of birth has no age to work from', async ({ page }, workerInfo) => {
+            const dbp = BrokerProtectionPage.create(page, workerInfo.project.use);
+            await dbp.enabled();
+            await dbp.navigatesTo('opt-out-form.html');
+            await dbp.receivesAction('fill-form-generated-dob-no-age.json');
+            const response = await dbp.collector.waitForMessage('actionCompleted');
+            dbp.isErrorMessage(response);
+            await dbp.doesInputValueEqual('#Dob', '');
+        });
+
         test('fillForm errors when an element type is in neither known keys nor extras', async ({ page }, workerInfo) => {
             const dbp = BrokerProtectionPage.create(page, workerInfo.project.use);
             await dbp.enabled();
diff --git a/injected/integration-test/page-objects/broker-protection.js b/injected/integration-test/page-objects/broker-protection.js
@@ -90,6 +90,21 @@ export class BrokerProtectionPage {
         expect(actualValue).toEqual(desiredValue);
     }
 
+    /**
+     * @param {string} selector - the selector for an `<input type="date">`
+     * @param {number} age - the age the filled date of birth should imply as of today
+     * @return {Promise<void>}
+     */
+    async isDateOfBirthForAge(selector, age) {
+        const value = await this.getFormFieldValue(selector);
+        expect(value).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+
+        const [year, month, day] = value.split('-').map(Number);
+        const today = new Date();
+        const birthdayThisYear = new Date(today.getFullYear(), month - 1, day);
+        expect(today.getFullYear() - year - (today < birthdayThisYear ? 1 : 0)).toBe(age);
+    }
+
     /**
      * @param {string} responseElementSelector
      * @return {Promise<void>}
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-address-selection.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-address-selection.json
@@ -15,8 +15,8 @@
             "extractedProfile": {
                 "name": "John Sample",
                 "addresses": [
-                    { "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } },
-                    { "city": "Livingston", "state": "TX", "extras": { "street": "197 Carlisle Rd", "zip": "77351" } }
+                    { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } },
+                    { "city": "Livingston", "state": "TX", "extras": { "street": "300 Example Rd", "zip": "77351" } }
                 ]
             },
             "userProfile": {
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-missing.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-missing.json
@@ -11,7 +11,7 @@
             "extractedProfile": {
                 "name": "John Sample",
                 "addresses": [
-                    { "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } }
+                    { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } }
                 ]
             },
             "userProfile": {
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-no-user-profile.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras-no-user-profile.json
@@ -14,8 +14,8 @@
             "extractedProfile": {
                 "name": "John Sample",
                 "addresses": [
-                    { "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } },
-                    { "city": "Livingston", "state": "TX", "extras": { "street": "197 Carlisle Rd", "zip": "77351" } }
+                    { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } },
+                    { "city": "Livingston", "state": "TX", "extras": { "street": "300 Example Rd", "zip": "77351" } }
                 ]
             }
         }
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-extras.json
@@ -20,7 +20,7 @@
                 "middleName": "Andrew",
                 "lastName": "Sample",
                 "name": "John Sample",
-                "addresses": [{ "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } }]
+                "addresses": [{ "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } }]
             },
             "userProfile": {
                 "firstName": "John",
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-generated-dob-no-age.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-generated-dob-no-age.json
@@ -0,0 +1,17 @@
+{
+    "state": {
+        "action": {
+            "actionType": "fillForm",
+            "id": "fill-generated-dob-no-age",
+            "selector": "#contact-form",
+            "dataSource": "extractedProfile",
+            "elements": [{ "type": "$generated_dob$", "selector": ".//input[@id='Dob']" }]
+        },
+        "data": {
+            "extractedProfile": {
+                "name": "John Sample",
+                "addresses": [{ "city": "Baytown", "state": "TX" }]
+            }
+        }
+    }
+}
diff --git a/injected/integration-test/test-pages/broker-protection/actions/fill-form-generated-dob.json b/injected/integration-test/test-pages/broker-protection/actions/fill-form-generated-dob.json
@@ -0,0 +1,30 @@
+{
+    "state": {
+        "action": {
+            "actionType": "fillForm",
+            "id": "fill-generated-dob",
+            "selector": "#contact-form",
+            "dataSource": "extractedProfile",
+            "elements": [
+                { "type": "$generated_dob$", "selector": ".//input[@id='Dob']" },
+                { "type": "street", "selector": ".//input[@id='StreetAddress']" },
+                { "type": "city", "selector": ".//input[@id='City']" },
+                { "type": "state", "selector": ".//input[@id='State']" }
+            ]
+        },
+        "data": {
+            "extractedProfile": {
+                "name": "John Sample",
+                "age": "51",
+                "addresses": [
+                    { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } }
+                ]
+            },
+            "userProfile": {
+                "firstName": "John",
+                "lastName": "Sample",
+                "addresses": [{ "city": "Baytown", "state": "TX" }]
+            }
+        }
+    }
+}
diff --git a/injected/integration-test/test-pages/broker-protection/pages/opt-out-form.html b/injected/integration-test/test-pages/broker-protection/pages/opt-out-form.html
@@ -6,9 +6,7 @@
     </head>
     <body>
         <!--
-            A simplified version of the CyberBackgroundChecks opt-out form with plain text
-            Street/City/State inputs (and no zip field), for exercising the fillForm extras/address
-            path.
+            A simplified version of the CyberBackgroundChecks opt-out form.
         -->
         <div class="card-body">
             <h1 class="card-title">Record Suppression Form</h1>
@@ -22,6 +20,9 @@ <h1 class="card-title">Record Suppression Form</h1>
                 <label for="LastName">Last Name</label>
                 <input class="form-control" id="LastName" maxlength="50" name="LastName" type="text" value="" />
 
+                <label for="Dob">Date of Birth</label>
+                <input class="form-control" id="Dob" name="Dob" type="date" value="" />
+
                 <label for="StreetAddress">Street Address</label>
                 <input class="form-control" id="StreetAddress" maxlength="50" name="StreetAddress" type="text" value="" />
 
diff --git a/injected/integration-test/test-pages/broker-protection/pages/results-address-href.html b/injected/integration-test/test-pages/broker-protection/pages/results-address-href.html
@@ -20,9 +20,9 @@ <h2>
 
                 <div class="text-base">
                     <h3 class="inline">Past Addresses:</h3>
-                    <a href="/address/1591-oakmont-dr/acworth-ga-30102" title="">Acworth, GA</a> •
+                    <a href="/address/100-sample-dr/acworth-ga-30102" title="">Acworth, GA</a> •
                     <a href="/address/po-box-42/dayton-oh-45402" title="">Dayton, OH</a> •
-                    <a href="/address/250-elm-st/franklin-tn-37064" title="">Franklin, TN</a>
+                    <a href="/address/250-example-st/franklin-tn-37064" title="">Franklin, TN</a>
                 </div>
 
                 <div class="text-base">
diff --git a/injected/integration-test/test-pages/broker-protection/pages/results-address-text.html b/injected/integration-test/test-pages/broker-protection/pages/results-address-text.html
@@ -16,13 +16,13 @@
             </div>
             <div class="card-body">
                 <p class="address-current">
-                    <a class="address" href="/address/1">2323 Bay Hill Dr, Baytown, TX 77523</a>
+                    <a class="address" href="/address/1">100 Sample Dr, Baytown, TX 77523</a>
                 </p>
                 <p class="address-previous">
-                    <a class="address" href="/address/2">197 Carlisle Rd, Livingston, TX 77351</a>
+                    <a class="address" href="/address/2">300 Example Rd, Livingston, TX 77351</a>
                 </p>
                 <p class="address-previous">
-                    <a class="address" href="/address/3">455 Pine Grove Ln, Livingston, TX 77351</a>
+                    <a class="address" href="/address/3">400 Example Ln, Livingston, TX 77351</a>
                 </p>
             </div>
         </div>
diff --git a/injected/integration-test/test-pages/broker-protection/pages/results-address-title.html b/injected/integration-test/test-pages/broker-protection/pages/results-address-title.html
@@ -17,10 +17,10 @@ <h3 class="card-title">
 
                 <div>
                     <h4>Past Addresses:</h4>
-                    <a href="/address/1" title="Property details for the address 2323 Bay Hill Dr, Baytown TX 77523">Baytown, TX</a> •
-                    <a href="/address/2" title="Property details for the address 1810 Bayou Breeze Dr, Baytown TX 77523">Baytown, TX</a> •
-                    <a href="/address/3" title="Property details for the address 197 Carlisle Rd, Livingston TX 77351">Livingston, TX</a> •
-                    <a href="/address/4" title="Property details for the address 455 Pine Grove Ln, Livingston TX 77351">Livingston, TX</a>
+                    <a href="/address/1" title="Property details for the address 100 Sample Dr, Baytown TX 77523">Baytown, TX</a> •
+                    <a href="/address/2" title="Property details for the address 200 Sample Ct, Baytown TX 77523">Baytown, TX</a> •
+                    <a href="/address/3" title="Property details for the address 300 Example Rd, Livingston TX 77351">Livingston, TX</a> •
+                    <a href="/address/4" title="Property details for the address 400 Example Ln, Livingston TX 77351">Livingston, TX</a>
                 </div>
 
                 <div>
diff --git a/injected/src/features/broker-protection/actions/fill-form.js b/injected/src/features/broker-protection/actions/fill-form.js
@@ -1,6 +1,6 @@
 import { getElement, generateRandomInt } from '../utils/utils.js';
 import { ErrorResponse, SuccessResponse } from '../types.js';
-import { generatePhoneNumber, generateZipCode, generateStreetAddress } from './generators.js';
+import { generatePhoneNumber, generateZipCode, generateStreetAddress, generateDateOfBirth } from './generators.js';
 import { states } from '../comparisons/constants.js';
 import { sameCityState } from '../comparisons/address.js';
 
@@ -85,6 +85,16 @@ export function fillMany(root, elements, data, userProfile = null) {
             results.push(setValueForInput(inputElem, generateRandomInt(parseInt(element.min), parseInt(element.max)).toString()));
         } else if (element.type === '$generated_street_address$') {
             results.push(setValueForInput(inputElem, generateStreetAddress()));
+        } else if (element.type === '$generated_dob$') {
+            const age = parseInt(lookupValue('age', data, address, extras), 10);
+            if (!Number.isFinite(age) || age < 0) {
+                results.push({
+                    result: false,
+                    error: `element found with selector '${element.selector}', but data didn't contain an 'age' to generate a date of birth from`,
+                });
+                continue;
+            }
+            results.push(setValueForInput(inputElem, generateDateOfBirth(age)));
         } else if (element.type === 'cityState') {
             const city = Object.prototype.hasOwnProperty.call(data, 'city') ? data.city : address?.city;
             const state = Object.prototype.hasOwnProperty.call(data, 'state') ? data.state : address?.state;
diff --git a/injected/src/features/broker-protection/actions/generators.js b/injected/src/features/broker-protection/actions/generators.js
@@ -19,6 +19,24 @@ export function generateZipCode() {
     return zipCode;
 }
 
+/**
+ * A random date of birth for someone who is `age` years old, in the `YYYY-MM-DD` format.
+ *
+ * @param {number} age
+ * @param {Date} [today]
+ * @return {string}
+ */
+export function generateDateOfBirth(age, today = new Date()) {
+    const dob = new Date(today.getFullYear() - age, today.getMonth(), today.getDate());
+    // If `today` is a leap day (Feb 29) then `dob` at this point is March 1. Go back to last day of prev month (Feb 28).
+    if (dob.getMonth() !== today.getMonth()) dob.setDate(0);
+    dob.setDate(dob.getDate() - generateRandomInt(0, 364));
+
+    const month = (dob.getMonth() + 1).toString().padStart(2, '0');
+    const day = dob.getDate().toString().padStart(2, '0');
+    return `${dob.getFullYear()}-${month}-${day}`;
+}
+
 export function generateStreetAddress() {
     const streetDigits = generateRandomInt(1, 5);
     const streetNumber = generateRandomInt(2, streetDigits * 1000);
diff --git a/injected/unit-test/broker-protection.js b/injected/unit-test/broker-protection.js
@@ -8,7 +8,12 @@ import { replaceTemplatedUrl } from '../src/features/broker-protection/actions/b
 import { processTemplateStringWithUserData } from '../src/features/broker-protection/actions/build-url-transforms.js';
 import { names } from '../src/features/broker-protection/comparisons/constants.js';
 import { generateRandomInt, hashObject, sortAddressesByStateAndCity } from '../src/features/broker-protection/utils/utils.js';
-import { generatePhoneNumber, generateZipCode, generateStreetAddress } from '../src/features/broker-protection/actions/generators.js';
+import {
+    generatePhoneNumber,
+    generateZipCode,
+    generateStreetAddress,
+    generateDateOfBirth,
+} from '../src/features/broker-protection/actions/generators.js';
 import { ProfileHashTransformer } from '../src/features/broker-protection/extractors/profile-url.js';
 import { getComparisonFunction } from '../src/features/broker-protection/actions/click.js';
 import { selectAddress } from '../src/features/broker-protection/actions/fill-form.js';
@@ -719,6 +724,34 @@ describe('generators', () => {
             });
         });
     });
+    describe('generateDateOfBirth', () => {
+        /**
+         * @param {string} dob - `YYYY-MM-DD`
+         * @param {Date} on
+         * @return {number}
+         */
+        function ageOn(dob, on) {
+            const [year, month, day] = dob.split('-').map(Number);
+            const birthdayThatYear = new Date(on.getFullYear(), month - 1, day);
+            return on.getFullYear() - year - (on < birthdayThatYear ? 1 : 0);
+        }
+
+        // A leap day, the day before one, and an ordinary day
+        const days = [new Date(2028, 1, 29), new Date(2028, 1, 28), new Date(2026, 6, 28)];
+
+        it('generates a date of birth for someone of exactly that age', () => {
+            days.forEach((today) => {
+                [0, 18, 41, 99].forEach((age) => {
+                    // Enough draws to cover the whole year the date can be picked from
+                    Array.from({ length: 365 }).forEach(() => {
+                        const dob = generateDateOfBirth(age, today);
+                        expect(dob).toMatch(/^\d{4}-\d{2}-\d{2}$/);
+                        expect(ageOn(dob, today)).toBe(age);
+                    });
+                });
+            });
+        });
+    });
 });
 
 describe('captcha-services', () => {

Original file line number	Diff line number	Diff line change
`@@ -11,7 +11,7 @@`
`11`	`11`	`"extractedProfile": {`
`12`	`12`	`"name": "John Sample",`
`13`	`13`	`"addresses": [`
`14`		`- { "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } }`
	`14`	`+ { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } }`
`15`	`15`	`]`
`16`	`16`	`},`
`17`	`17`	`"userProfile": {`
Original file line number	Diff line number	Diff line change
`@@ -14,8 +14,8 @@`
`14`	`14`	`"extractedProfile": {`
`15`	`15`	`"name": "John Sample",`
`16`	`16`	`"addresses": [`
`17`		`- { "city": "Baytown", "state": "TX", "extras": { "street": "2323 Bay Hill Dr", "zip": "77523" } },`
`18`		`- { "city": "Livingston", "state": "TX", "extras": { "street": "197 Carlisle Rd", "zip": "77351" } }`
	`17`	`+ { "city": "Baytown", "state": "TX", "extras": { "street": "100 Sample Dr", "zip": "77523" } },`
	`18`	`+ { "city": "Livingston", "state": "TX", "extras": { "street": "300 Example Rd", "zip": "77351" } }`
`19`	`19`	`]`
`20`	`20`	`}`
`21`	`21`	`}`