feat: add isTimeoutError function for detecting timeout errors

[konard]

Summary

• Adds new isTimeoutError function to detect timeout errors from selector waiting operations
• Exports the function from the main package entry point alongside isNavigationError
• Includes 14 comprehensive unit tests covering various timeout error scenarios from both Playwright and Puppeteer

Why This Is Needed

Timeout errors are distinct from navigation errors and should be handled differently:

• Navigation errors (isNavigationError): Page context destroyed, frame detached - usually unrecoverable for current operation
• Timeout errors (isTimeoutError): Element not found within timeout - automation can continue with next item

Both functions are complementary and work together to provide robust error handling in browser automation.

Implementation Details

The function checks:

1. Error name === 'TimeoutError' (most reliable)
2. Error message patterns (case-insensitive): 'waiting for selector', 'timeout', 'timeouterror', 'timeout exceeded', 'timed out'

Usage Example

import { isNavigationError, isTimeoutError } from 'browser-commander';

try {
  await page.waitForSelector('.button', { timeout: 5000 });
} catch (error) {
  if (isTimeoutError(error)) {
    console.log('⚠️  Timeout error occurred while waiting for page elements');
    console.log('   The automation will continue with the next item');
  } else if (isNavigationError(error)) {
    console.log('Page navigation occurred during wait');
  } else {
    throw error;
  }
}

Test Plan

• All 351 unit tests pass
• ESLint checks pass (no errors in changed files)
• Prettier formatting check passes
• New isTimeoutError tests cover:
  • Null/undefined/empty error handling
  • Error name 'TimeoutError' detection
  • Various timeout message patterns
  • Case-insensitive matching
  • Not matching navigation errors (to avoid false positives)

Related

Fixes #9

🤖 Generated with Claude Code

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost estimation:

• Public pricing estimate: $3.075377 USD
• Calculated by Anthropic: $1.925706 USD
• Difference: $-1.149671 (-37.38%)
  📎 Log file uploaded as GitHub Gist (440KB)
  🔗 View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.