Rewrites the web app's comments to rule 32. Task, milestone, rule and spec ids are gone; regression stories are restated as the trap they guard (public auth routes, the menu's stopPropagation, universal loads under adapter-static, metric deltas with their margin). Flutter and Tauri mentions now name the Android app or a native shell, operator quotes and dates are dropped, and one library's counts no longer appear outside test fixtures. Verified with a TypeScript-scanner token comparison (template literals and regex literals re-scanned): only comment text changed. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
59 lines
2.5 KiB
TypeScript
59 lines
2.5 KiB
TypeScript
import { queryClient } from '#lib/query/client.js';
|
|
import { qk } from '#lib/api/queries.js';
|
|
import { user } from '#lib/auth/store.svelte.js';
|
|
|
|
// Inbound server events over SSE. The web client's OUTBOUND half (play
|
|
// events) lives in player/events.svelte.ts; this is the inbound listener.
|
|
// It reacts to `playlist.system_rebuilt` — the
|
|
// daily 03:00 rebuild or a manual refresh — by invalidating the home +
|
|
// system-playlist query caches so a tab left open across the rebuild stops
|
|
// serving yesterday's snapshot. Active playback
|
|
// self-heals separately on the failure path (store.handleLoadFailure); we
|
|
// deliberately do NOT yank a playing queue here — that would interrupt a
|
|
// mid-song listen to restart the new mix at track 0.
|
|
|
|
// Monotonic rebuild counter. Bumped on every playlist.system_rebuilt.
|
|
// An open system-playlist DETAIL page can't be invalidated in place (its id
|
|
// rotates on rebuild — a refetch would 404), so instead it watches this
|
|
// counter and offers a "this mix was refreshed → Refresh" affordance that
|
|
// re-resolves the variant to the new playlist.
|
|
let _systemRebuildCount = $state(0);
|
|
export const systemRebuilt = {
|
|
get count(): number {
|
|
return _systemRebuildCount;
|
|
}
|
|
};
|
|
|
|
function onSystemRebuilt(): void {
|
|
_systemRebuildCount++;
|
|
queryClient.invalidateQueries({ queryKey: qk.home() });
|
|
// Prefix match invalidates every kind ('user' | 'system' | 'all').
|
|
queryClient.invalidateQueries({ queryKey: ['playlists'] });
|
|
queryClient.invalidateQueries({ queryKey: qk.systemPlaylistsStatus() });
|
|
}
|
|
|
|
// A new notification for this user. The frame carries no content — it
|
|
// is a nudge — so the inbox and badge refetch rather than trusting a payload.
|
|
function onNotificationCreated(): void {
|
|
queryClient.invalidateQueries({ queryKey: ['notifications'] });
|
|
}
|
|
|
|
// Wire once from +layout.svelte's mount. Opens the stream only while
|
|
// authenticated and closes it on logout; EventSource auto-reconnects on
|
|
// transient network drops.
|
|
export function useServerEvents(): void {
|
|
$effect(() => {
|
|
if (!user.value) return;
|
|
// Absent under SSR / jsdom — the listener simply no-ops there.
|
|
if (typeof EventSource === 'undefined') return;
|
|
const es = new EventSource('/api/events/stream');
|
|
es.addEventListener('playlist.system_rebuilt', onSystemRebuilt);
|
|
es.addEventListener('notification.created', onNotificationCreated);
|
|
return () => {
|
|
es.removeEventListener('playlist.system_rebuilt', onSystemRebuilt);
|
|
es.removeEventListener('notification.created', onNotificationCreated);
|
|
es.close();
|
|
};
|
|
});
|
|
}
|