fix(sia-video-source): widen media target types

[pcfreak30]

Updates private helpers to accept Video.js media target capabilities instead of requiring a concrete HTML video element.

Adds structural contract coverage and leaves runtime output and public declarations unchanged.

---

Summary

This PR widens the media target type used by SiaVideoSource internal helpers from HTMLVideoElement to HTMLVideoTargetLike, allowing the source to operate with any video-host-compatible element rather than being limited to a plain HTMLVideoElement. It also adds compile-time regression tests that pin the structural contract the widened helpers depend on.

Changes

• Broadened target types in internal helpers (sia-video-source.ts):

  • #applyPendingReanchor() now accepts HTMLVideoTargetLike | null instead of HTMLVideoElement | null.
  • #forceClearStuckSeek() and the HANDLE message handler no longer cast this.target to HTMLVideoElement; they use the wider HTMLVideoTargetLike type directly.
  • nativeBufferedEnd() now takes HTMLVideoTargetLike instead of HTMLVideoElement.

• Added type-contract regression tests (video-host-target-contract.spec.ts):

  • Asserts that HTMLVideoTargetLike still exposes a writable numeric currentTime.
  • Asserts that HTMLVideoTargetLike still exposes a buffered property of type TimeRangeLike.

These tests guard against future upstream changes to the @videojs/media video-host types that could silently break the widened parameter assumptions.

Why

The Sia video source relies on common media-element capabilities (currentTime, buffered, srcObject, etc.) rather than anything video-specific. Switching the internal helper signatures from HTMLVideoElement to HTMLVideoTargetLike makes the source compatible with other video-host targets while preserving type safety through compile-time assertions.

[kody-ai]

Kody Review Complete

Great news! 🎉
No issues were found that match your current review configurations.

Keep up the excellent work! 🚀

Kody Guide: Usage and Configuration

Interacting with Kody

• Request a Review: Ask Kody to review your PR manually by adding a comment with the @kody start-review command at the root of your PR.

• Validate Business Logic: Ask Kody to validate your code against business rules by adding a comment with the @kody -v business-logic command.

• Provide Feedback: Help Kody learn and improve by reacting to its comments with a 👍 for helpful suggestions or a 👎 if improvements are needed.

Current Kody Configuration

Review Options

The following review options are enabled or disabled:

Options	Enabled
Bug	✅
Performance	✅
Security	✅
Business Logic	✅

Access your configuration settings here.

​