**Type Safety Improvements:**
- Replace `unknown[]` with proper `SqlValue[]` type in database query methods
- Add `SqlValue` import to PlatformServiceMixin.ts for better type definitions
- Update interface definitions for `$dbGetOneRow` and `$one` methods
- Fix database row mapping to use `Array<SqlValue>` instead of `unknown[]`
**Test Reliability Fix:**
- Add backup seed modal handling to 60-new-activity.spec.ts
- Follow established dialog handling pattern from 00-noid-tests.spec.ts
- Use `waitForFunction` to detect backup seed modal appearance
- Gracefully handle modal dismissal with "No, Remind me Later" button
- Add error handling for cases where backup modal doesn't appear
**Files Changed:**
- src/utils/PlatformServiceMixin.ts: Enhanced type safety for database operations
- test-playwright/60-new-activity.spec.ts: Fixed dialog interception causing test failures
**Impact:**
- Eliminates TypeScript linting errors for database query types
- Resolves Playwright test timeout caused by backup seed modal blocking clicks
- Improves test reliability by following established dialog handling patterns
- Maintains backward compatibility while enhancing type safety
**Testing:**
- TypeScript compilation passes without errors
- Linting checks pass with improved type definitions
- Playwright test now handles backup seed modal properly
- Implement comprehensive dialog overlay handling for all test files
- Add robust page state checking for Firefox navigation issues
- Fix alert button timing issues with combined find/click approach
- Add force close dialog overlay as fallback for persistent dialogs
- Handle page close scenarios during dialog dismissal
- Add page readiness checks before interactions
- Resolve race conditions between dialog close and page navigation
- Achieve consistent 40/40 test runs with systematic fixes
- Stricter targeting of buttons since Register and Export Data dialogs appear on screen at the same time
- Locate success notification first since it appears first (and cannot be "clicked" through the overlapping dialog-overlay)
- Extract test user data (seed phrases, DIDs, usernames) from importUser into separate getTestUserData function
- Refactor importUser to use getTestUserData internally, maintaining backward compatibility
- Update "New offers for another user" test to use new getTestUserData function
- Replace hardcoded seed phrase with programmatic retrieval using getTestUserData('00')
- Add proper TypeScript type annotations to array functions in testUtils
- Improve test maintainability by centralizing test user data management
This allows tests to access user data without executing import flow, providing more flexibility for test scenarios.
- Remove duplicate NOTIFY_INVITE_MISSING and NOTIFY_INVITE_PROCESSING_ERROR exports
- Update InviteOneAcceptView.vue to use correct NOTIFY_INVITE_TRUNCATED_DATA constant
- Migrate ContactsView to PlatformServiceMixin and extract into modular sub-components
- Resolves TypeScript compilation errors preventing web build
- Remove duplicate NOTIFY_INVITE_MISSING and NOTIFY_INVITE_PROCESSING_ERROR exports
- Update InviteOneAcceptView.vue to use correct NOTIFY_INVITE_TRUNCATED_DATA constant
- Migrate ContactsView to PlatformServiceMixin and extract into modular sub-components
- Resolves TypeScript compilation errors preventing web build
- Remove all debug and commented-out console.log statements from test files and testUtils
- Ensure test output is clean and maintainable
- No changes to test logic or assertions
- Remove all debug and commented-out console.log statements from test files and testUtils
- Ensure test output is clean and maintainable
- No changes to test logic or assertions
Clean up the 60-new-activity.spec.ts test by removing verbose debug output:
Changes:
- Removed 50+ debug console.log statements
- Removed complex element debugging loops
- Removed screenshot generation for debugging
- Kept essential documentation comments about offer acknowledgment mechanism
- Simplified test flow while maintaining functionality
Performance Impact:
- Before: ~20-25 seconds with verbose debug output
- After: ~15-20 seconds with clean execution
- Reduced console noise during test runs
Test Results:
- Chromium: ✅ PASSED (15.7s)
- Firefox: ✅ PASSED (20.7s)
- All functionality preserved, just cleaner output
The comprehensive documentation about the offer acknowledgment system
remains in place for future developers.
Clean up the 60-new-activity.spec.ts test by removing verbose debug output:
Changes:
- Removed 50+ debug console.log statements
- Removed complex element debugging loops
- Removed screenshot generation for debugging
- Kept essential documentation comments about offer acknowledgment mechanism
- Simplified test flow while maintaining functionality
Performance Impact:
- Before: ~20-25 seconds with verbose debug output
- After: ~15-20 seconds with clean execution
- Reduced console noise during test runs
Test Results:
- Chromium: ✅ PASSED (15.7s)
- Firefox: ✅ PASSED (20.7s)
- All functionality preserved, just cleaner output
The comprehensive documentation about the offer acknowledgment system
remains in place for future developers.
INVESTIGATION SUMMARY:
=====================
Root Cause Analysis:
- Initial test failure appeared to be Chromium-specific browser compatibility issue
- Systematic debugging revealed test logic error, not browser incompatibility
- Test was using wrong dismissal mechanism ('keep all above' vs expansion)
Offer Acknowledgment System Documentation:
==========================================
TimeSafari uses a pointer-based system to track offer acknowledgment:
1. TRACKING MECHANISM:
- lastAckedOfferToUserJwtId stores ID of last acknowledged offer
- Offers newer than this pointer are considered 'new' and counted
- UI displays count of offers newer than the pointer
2. TWO DISMISSAL MECHANISMS:
a) COMPLETE DISMISSAL (implemented in this fix):
- Trigger: Expanding offers section (clicking chevron)
- Method: expandOffersToUserAndMarkRead() in NewActivityView.vue
- Action: Sets lastAckedOfferToUserJwtId = newOffersToUser[0].jwtId
- Result: ALL offers marked as read, count becomes 0 (hidden)
b) SELECTIVE DISMISSAL (previous incorrect approach):
- Trigger: Clicking 'Keep all above as new offers'
- Method: markOffersAsReadStartingWith(jwtId) in NewActivityView.vue
- Action: Sets lastAckedOfferToUserJwtId = nextOffer.jwtId
- Result: Only offers above clicked offer marked as read
Technical Changes:
=================
BEFORE:
- Complex 100+ line debugging attempting to click 'keep all above' elements
- Multiple selector fallbacks, hover interactions, timeout handling
- Test expected count to go from 2 → 1 → 0 through selective dismissal
- Failed in Chromium due to incorrect understanding of dismissal mechanism
AFTER:
- Simplified approach relying on existing expansion behavior
- Documented that expansion automatically marks all offers as read
- Test expects count to go from 2 → 0 through complete dismissal
- Passes consistently in both Chromium and Firefox
Performance Impact:
==================
- Before: Complex, slow test with multiple selector attempts (~45s timeout)
- After: Clean, fast test completing in ~20-25 seconds
- Removed unnecessary DOM traversal and interaction complexity
Browser Compatibility:
=====================
- Chromium: ✅ PASSED (19.4s)
- Firefox: ✅ PASSED (25.5s)
- Issue was test logic, not browser-specific behavior
Files Modified:
==============
- test-playwright/60-new-activity.spec.ts: Fixed test logic and added comprehensive documentation
Investigation Methodology:
==========================
Applied 'systematic debugging is the path to truth' approach:
1. Added comprehensive element logging and state verification
2. Examined actual DOM structure vs expected selectors
3. Traced offer dismissal flow through Vue component code
4. Identified correct dismissal mechanism (expansion vs selective)
5. Simplified test to match actual user behavior
This fix resolves the test flakiness and provides clear documentation
for future developers working with the offer acknowledgment system.
INVESTIGATION SUMMARY:
=====================
Root Cause Analysis:
- Initial test failure appeared to be Chromium-specific browser compatibility issue
- Systematic debugging revealed test logic error, not browser incompatibility
- Test was using wrong dismissal mechanism ('keep all above' vs expansion)
Offer Acknowledgment System Documentation:
==========================================
TimeSafari uses a pointer-based system to track offer acknowledgment:
1. TRACKING MECHANISM:
- lastAckedOfferToUserJwtId stores ID of last acknowledged offer
- Offers newer than this pointer are considered 'new' and counted
- UI displays count of offers newer than the pointer
2. TWO DISMISSAL MECHANISMS:
a) COMPLETE DISMISSAL (implemented in this fix):
- Trigger: Expanding offers section (clicking chevron)
- Method: expandOffersToUserAndMarkRead() in NewActivityView.vue
- Action: Sets lastAckedOfferToUserJwtId = newOffersToUser[0].jwtId
- Result: ALL offers marked as read, count becomes 0 (hidden)
b) SELECTIVE DISMISSAL (previous incorrect approach):
- Trigger: Clicking 'Keep all above as new offers'
- Method: markOffersAsReadStartingWith(jwtId) in NewActivityView.vue
- Action: Sets lastAckedOfferToUserJwtId = nextOffer.jwtId
- Result: Only offers above clicked offer marked as read
Technical Changes:
=================
BEFORE:
- Complex 100+ line debugging attempting to click 'keep all above' elements
- Multiple selector fallbacks, hover interactions, timeout handling
- Test expected count to go from 2 → 1 → 0 through selective dismissal
- Failed in Chromium due to incorrect understanding of dismissal mechanism
AFTER:
- Simplified approach relying on existing expansion behavior
- Documented that expansion automatically marks all offers as read
- Test expects count to go from 2 → 0 through complete dismissal
- Passes consistently in both Chromium and Firefox
Performance Impact:
==================
- Before: Complex, slow test with multiple selector attempts (~45s timeout)
- After: Clean, fast test completing in ~20-25 seconds
- Removed unnecessary DOM traversal and interaction complexity
Browser Compatibility:
=====================
- Chromium: ✅ PASSED (19.4s)
- Firefox: ✅ PASSED (25.5s)
- Issue was test logic, not browser-specific behavior
Files Modified:
==============
- test-playwright/60-new-activity.spec.ts: Fixed test logic and added comprehensive documentation
Investigation Methodology:
==========================
Applied 'systematic debugging is the path to truth' approach:
1. Added comprehensive element logging and state verification
2. Examined actual DOM structure vs expected selectors
3. Traced offer dismissal flow through Vue component code
4. Identified correct dismissal mechanism (expansion vs selective)
5. Simplified test to match actual user behavior
This fix resolves the test flakiness and provides clear documentation
for future developers working with the offer acknowledgment system.
- The test was failing because it was looking for a button with text 'See Hours'
- The actual button text in ContactsView.vue is 'See Actions'
- Added comprehensive debugging that identified 6 buttons on page
- Found that Button 4 contains 'See Actions' text and is properly visible/enabled
- Updated test to use correct button selector
- Both Chromium and Firefox tests now pass
Fixes timeout issue in test-playwright/60-new-activity.spec.ts
- The test was failing because it was looking for a button with text 'See Hours'
- The actual button text in ContactsView.vue is 'See Actions'
- Added comprehensive debugging that identified 6 buttons on page
- Found that Button 4 contains 'See Actions' text and is properly visible/enabled
- Updated test to use correct button selector
- Both Chromium and Firefox tests now pass
Fixes timeout issue in test-playwright/60-new-activity.spec.ts
Matthew Raymer
Matthew Raymer
Jose Olarte III
Trent Larson