[botinc-agent]

Problem

submitEvent() crashed with an untyped RangeError: Invalid time value when an integrator passed an invalid occurredAt Date (for example new Date("not a date") from a failed parse). buildEventRequestBody() called toISOString() before the documented input checks, so bad input escaped the SDK's DiditEventError contract and broke the caller's sign-in flow instead of reporting a validation problem.

Solution

• Validate occurredAt in submitEvent() and refuse an invalid Date with a typed validation error, matching the existing token and category checks.
• Document the extra validation case in the package README and the occurredAt type comment.
• Add a regression test that fails before the check and passes after it.

Verification

• Signals unit tests: 50 passed; full root Jest suite: 189 passed.
• npm run typecheck, npm run build and npm run test:size pass; the bundle is 5,107 of 5,120 bytes.
• Browser E2E: 191 passed, 7 credential-dependent skips across Chromium, Firefox and WebKit.
• Staging E2E: sign-up/login/logout and partial-batch outcomes pass against the staging API; exploratory staging checks covered page, sign-in and custom events, SPA navigation, 25-event batching, network retry, page exit, token refusal and subject binding. Test events and API keys were cleaned up.