playback-webview-debugging

name	playback-webview-debugging
description	Use when playback, auth recovery, queue sync, or hidden WebView state diverges from native Swift state and you need to debug the DRM playback WebView, bridge events, or cookie/auth behavior.
metadata	{"short-description":"Debug playback WebView state"}

Playback WebView Debugging

Use this skill when playback, auth recovery, queue sync, or hidden WebView state diverges from the native Swift state.

When To Use It

• Playback starts, stops, or advances unexpectedly
• Auth looks stale and API calls return 401/403
• WebView metadata drifts from the native queue
• You need to inspect JavaScript bridge events or DOM/player state

Runtime Workflow

1. Reproduce with the packaged app or Scripts/compile_and_run.sh.
2. Use Xcode Console filters to watch runtime logs: subsystem:Kaset category:player subsystem:Kaset category:auth
3. In debug builds, verify webView.isInspectable = true, then inspect the player WebView with Safari Web Inspector.
4. To simulate auth expiry, delete __Secure-3PAPISID via Safari Web Inspector storage tools and trigger an authenticated API call.
5. If auth cookies or headers look suspicious, run swift run api-explorer auth and compare against the exported cookie state.

Landmarks

• docs/testing.md
• docs/playback.md
• Sources/Kaset/Views/MiniPlayerWebView.swift
• Sources/Kaset/Views/SingletonPlayerWebView+ObserverScript.swift
• Sources/Kaset/Services/Player/PlayerService.swift
• Sources/Kaset/Services/Player/PlayerService+WebQueueSync.swift
• Sources/Kaset/Services/WebKit/WebKitManager.swift