(value: T | undefined): asserts value is T {\n\texpect(value).toBeDefined()\n}\n\n/** @public */\nexport const dbGetAllAndExpectLength = async (\n\tstoreName: S,\n\texpectedCount: number,\n\tmessage?: string,\n) => {\n\tconst db = await getDatabase()\n\tconst items = await db.getAll(storeName)\n\texpect(items, message).toHaveLength(expectedCount)\n\n\treturn items\n}\n"
},
{
"path": "src/lib/helpers/ui-action.ts",
"content": "/**\n * Executes a UI action that shows a success message upon completion or an error message if the action fails.\n */\nexport const createUIAction = (\n\tsuccessMessage: string | false,\n\taction: (...params: P) => Promise,\n) => {\n\tconst wrappedAction = async (...params: P): Promise => {\n\t\ttry {\n\t\t\tawait action(...params)\n\t\t\tif (successMessage) {\n\t\t\t\tsnackbar(successMessage)\n\t\t\t}\n\t\t} catch (error) {\n\t\t\tconsole.error('Error executing UI action:', error)\n\t\t\tsnackbar.unexpectedError(error)\n\t\t}\n\t}\n\n\treturn wrappedAction\n}\n"
},
{
"path": "src/lib/helpers/utils/array.ts",
"content": "/** @public */\nexport const toShuffledArray = (input: T[]): T[] => {\n\tconst output = [...input]\n\tfor (let i = output.length - 1; i > 0; i -= 1) {\n\t\tconst j = Math.floor(Math.random() * (i + 1))\n\t\tconst temp = output[i] as T\n\n\t\toutput[i] = output[j] as T\n\t\toutput[j] = temp\n\t}\n\n\treturn output\n}\n"
},
{
"path": "src/lib/helpers/utils/assign.ts",
"content": "// biome-ignore lint/suspicious/noExplicitAny: needed for inference\ntype Impossible = {\n\t[P in K]: never\n}\n\nexport const assign = >(\n\ttarget: T,\n\tsource: S & Impossible>,\n): S & T => Object.assign(target, source)\n"
},
{
"path": "src/lib/helpers/utils/clamp.ts",
"content": "export const clamp = (num: number, min: number, max: number): number =>\n\tMath.min(Math.max(num, min), max)\n"
},
{
"path": "src/lib/helpers/utils/debounce.ts",
"content": "/** @public */\nexport const debounce = ) => ReturnType>(\n\tfn: Fn,\n\tdelay: number,\n): {\n\t(...args: Parameters): void\n\tcancel: () => void\n} => {\n\tlet timeout: undefined | number\n\n\tconst debounceFn = (...args: Parameters) => {\n\t\tclearTimeout(timeout)\n\n\t\ttimeout = setTimeout(fn, delay, ...(args as unknown[]))\n\t}\n\n\tdebounceFn.cancel = () => {\n\t\tif (timeout) {\n\t\t\tclearTimeout(timeout)\n\t\t\ttimeout = undefined\n\t\t}\n\t}\n\n\treturn debounceFn\n}\n"
},
{
"path": "src/lib/helpers/utils/format-duration.ts",
"content": "const twoDigits = (num: number) => num.toString().padStart(2, '0')\n\nexport const formatDuration = (seconds: number) => {\n\tif (!Number.isFinite(seconds)) {\n\t\treturn '--:--'\n\t}\n\n\tconst hours = Math.floor(seconds / 3600)\n\tconst minutes = Math.floor((seconds % 3600) / 60)\n\tconst secs = Math.floor(seconds % 60)\n\n\treturn `${hours ? `${hours}:` : ''}${twoDigits(minutes)}:${twoDigits(secs)}`\n}\n"
},
{
"path": "src/lib/helpers/utils/integers.ts",
"content": "export const safeInteger = (num: number, fallback = 0): number => {\n\tif (Number.isSafeInteger(num)) {\n\t\treturn num\n\t}\n\n\treturn fallback\n}\n"
},
{
"path": "src/lib/helpers/utils/navigate.ts",
"content": "export const navigateToExternal = (url: string) => {\n\twindow.open(url, '_blank', 'noopener,noreferrer')\n}\n"
},
{
"path": "src/lib/helpers/utils/text.ts",
"content": "import { type StringOrUnknownItem, UNKNOWN_ITEM } from '$lib/library/types.ts'\n\nexport const truncate = (text: string, length: number): string => {\n\tif (text.length <= length) {\n\t\treturn text\n\t}\n\n\treturn `${text.slice(0, length)}...`\n}\n\nexport const formatArtists = (artists: readonly StringOrUnknownItem[]): string =>\n\tartists.filter((artist) => artist !== UNKNOWN_ITEM).join(', ')\n\nexport const formatNameOrUnknown = (name: StringOrUnknownItem, fallback = m.unknown()): string =>\n\tname === UNKNOWN_ITEM ? fallback : name\n\nexport const getItemLanguage = (language: string | undefined): string | undefined => {\n\tif (!language) {\n\t\treturn\n\t}\n\n\tconst lang = language.toLowerCase()\n\tswitch (lang) {\n\t\tcase 'jp':\n\t\tcase 'jap':\n\t\tcase 'japanese':\n\t\t\treturn 'ja'\n\n\t\tcase 'korean':\n\t\t\treturn 'ko'\n\n\t\tcase 'zh-cn':\n\t\t\treturn 'zh-CN'\n\n\t\tcase 'zh-tw':\n\t\t\treturn 'zh-TW'\n\n\t\tcase 'zho':\n\t\tcase 'chinese':\n\t\tcase 'zh':\n\t\t\treturn 'zh-CN'\n\n\t\tcase 'cantonese':\n\t\t\treturn 'yue'\n\n\t\tcase 'fre':\n\t\tcase 'french':\n\t\t\treturn 'fr'\n\n\t\tcase 'esp':\n\t\tcase 'spanish':\n\t\t\treturn 'es'\n\n\t\tcase 'eng':\n\t\tcase 'english':\n\t\t\treturn 'en'\n\n\t\tdefault:\n\t\t\treturn lang\n\t}\n}\n"
},
{
"path": "src/lib/helpers/utils/throttle.ts",
"content": "export const throttle = ) => ReturnType>(\n\tfn: Fn,\n\tdelay: number,\n): {\n\t(...args: Parameters): ReturnType\n\tcancel: () => void\n} => {\n\tlet wait = false\n\tlet timeout: undefined | number\n\tlet prevValue: ReturnType | undefined\n\n\tconst throttleFn = (...args: Parameters) => {\n\t\tif (wait) {\n\t\t\t// prevValue always defined by the\n\t\t\t// time wait is true\n\t\t\treturn prevValue as ReturnType\n\t\t}\n\n\t\tconst val = fn(...args)\n\t\tprevValue = val\n\n\t\twait = true\n\n\t\ttimeout = window.setTimeout(() => {\n\t\t\twait = false\n\t\t}, delay)\n\n\t\treturn val\n\t}\n\tthrottleFn.cancel = () => {\n\t\tclearTimeout(timeout)\n\t}\n\treturn throttleFn\n}\n"
},
{
"path": "src/lib/helpers/utils/ua.ts",
"content": "const isMobileRegex = /Android|iPhone|iPad|iPod/i\nconst isMacRegex = /Macintosh|Mac OS X/i\nconst isWindowsRegex = /Windows/i\nconst isAndroidRegex = /Android/i\n\nconst runOnce = (fn: () => T): (() => T) => {\n\tlet result: T\n\tlet hasRun = false\n\n\treturn () => {\n\t\tif (hasRun) {\n\t\t\treturn result\n\t\t}\n\n\t\tresult = fn()\n\t\thasRun = true\n\n\t\treturn result\n\t}\n}\n\n/** @public */\nexport const isMobile = runOnce((): boolean => {\n\tif (navigator.userAgentData) {\n\t\treturn navigator.userAgentData.mobile\n\t}\n\n\treturn isMobileRegex.test(navigator.userAgent)\n})\n\n/** @public */\nexport const isSafari = runOnce(() => {\n\tconst ua = navigator.userAgent.toLowerCase()\n\n\treturn ua.includes('applewebkit') && !ua.includes('chrome') && !ua.includes('chromium')\n})\n\n/** @public */\nexport const isMac = runOnce((): boolean => {\n\tif (navigator.userAgentData?.platform) {\n\t\treturn navigator.userAgentData.platform === 'macOS'\n\t}\n\n\treturn isMacRegex.test(navigator.userAgent)\n})\n\n/** @public */\nexport const isWindows = runOnce((): boolean => {\n\tif (navigator.userAgentData?.platform) {\n\t\treturn navigator.userAgentData.platform === 'Windows'\n\t}\n\n\treturn isWindowsRegex.test(navigator.userAgent)\n})\n\nexport const isAndroid = runOnce((): boolean => {\n\tif (navigator.userAgentData) {\n\t\treturn navigator.userAgentData.platform === 'Android'\n\t}\n\n\treturn isAndroidRegex.test(navigator.userAgent)\n})\n\nexport const isChromiumBased = runOnce((): boolean => {\n\t// All of our supported Chromium versions will have this property\n\tif (navigator.userAgentData) {\n\t\treturn navigator.userAgentData.brands.some((brand) =>\n\t\t\tbrand.brand.toLowerCase().includes('chromium'),\n\t\t)\n\t}\n\n\treturn false\n})\n\n/**\n * Returns whether the primary modifier key is pressed.\n * On Mac this is the Meta key (Cmd), on Windows/Linux it's the Ctrl key.\n * @public\n */\nexport const isPrimaryModifierKey = (event: KeyboardEvent | MouseEvent): boolean => {\n\tif (isMac()) {\n\t\treturn event.metaKey\n\t}\n\n\treturn event.ctrlKey\n}\n"
},
{
"path": "src/lib/helpers/utils/wait.ts",
"content": "/** @public */\nexport const wait = (duration: number): Promise =>\n\tnew Promise((resolve) => {\n\t\tsetTimeout(resolve, duration)\n\t})\n"
},
{
"path": "src/lib/helpers/virtualizer.svelte.ts",
"content": "import { Virtualizer, type VirtualizerOptions } from '@tanstack/virtual-core'\n\nexport * from '@tanstack/virtual-core'\n\nexport function createVirtualizerBase<\n\tTScrollElement extends Element | Window,\n\tTItemElement extends Element,\n>(\n\toptions: () => VirtualizerOptions,\n): Virtualizer {\n\tconst instance = new Virtualizer(options())\n\n\tlet virtualItems = $state(instance.getVirtualItems())\n\tlet totalSize = $state(instance.getTotalSize())\n\n\tconst virtualizer = new Proxy(instance, {\n\t\tget(target, prop) {\n\t\t\tswitch (prop) {\n\t\t\t\tcase 'getVirtualItems':\n\t\t\t\t\treturn () => virtualItems\n\t\t\t\tcase 'getTotalSize':\n\t\t\t\t\treturn () => totalSize\n\t\t\t\tdefault:\n\t\t\t\t\treturn Reflect.get(target, prop)\n\t\t\t}\n\t\t},\n\t})\n\n\t$effect(() => {\n\t\tconst cleanup = untrack(() => {\n\t\t\tconst cleanupInner = virtualizer._didMount()\n\n\t\t\treturn cleanupInner\n\t\t})\n\n\t\treturn cleanup\n\t})\n\n\t$effect(() => {\n\t\tconst resolvedOptions = options()\n\n\t\tvirtualizer.setOptions({\n\t\t\t...resolvedOptions,\n\t\t\tonChange: (instance, sync) => {\n\t\t\t\tinstance._willUpdate()\n\t\t\t\tvirtualItems = instance.getVirtualItems()\n\t\t\t\ttotalSize = instance.getTotalSize()\n\t\t\t\tresolvedOptions.onChange?.(instance, sync)\n\t\t\t},\n\t\t})\n\n\t\tvirtualizer.measure()\n\t})\n\n\treturn virtualizer\n}\n"
},
{
"path": "src/lib/layout-bottom-bar.svelte.ts",
"content": "import { createContext } from 'svelte'\nimport { SvelteMap } from 'svelte/reactivity'\n\nexport interface BottomBarState {\n\tbottomBar: Snippet | null\n\tabovePlayer: SvelteMap\n}\n\nconst [getContext, setContext] = createContext()\n\nexport const setupOverlaySnippets = () => {\n\tconst state: BottomBarState = $state({\n\t\tbottomBar: null,\n\t\tabovePlayer: new SvelteMap(),\n\t})\n\n\tsetContext(state)\n\n\treturn {\n\t\tget bottomBar(): BottomBarState['bottomBar'] {\n\t\t\treturn state.bottomBar\n\t\t},\n\t\tget abovePlayer(): Snippet[] {\n\t\t\treturn [...state.abovePlayer.values()]\n\t\t},\n\t}\n}\n\nlet counter = 0\n\nexport const useSetOverlaySnippet = (\n\ttype: 'bottom-bar' | 'above-player',\n\tgetSnippet: () => Snippet | null,\n): void => {\n\tconst state = getContext()\n\tconst id = counter\n\tcounter += 1\n\n\t$effect.pre(() => {\n\t\tif (type === 'bottom-bar') {\n\t\t\tstate.bottomBar = getSnippet()\n\n\t\t\treturn () => {\n\t\t\t\tstate.bottomBar = null\n\t\t\t}\n\t\t}\n\n\t\tif (type === 'above-player') {\n\t\t\tconst snippet = getSnippet()\n\n\t\t\tif (snippet) {\n\t\t\t\tstate.abovePlayer.set(id, snippet)\n\t\t\t} else {\n\t\t\t\tstate.abovePlayer.delete(id)\n\t\t\t}\n\n\t\t\treturn () => {\n\t\t\t\tstate.abovePlayer.delete(id)\n\t\t\t}\n\t\t}\n\n\t\treturn undefined\n\t})\n}\n"
},
{
"path": "src/lib/library/__tests__/play-history.test.ts",
"content": "import 'fake-indexeddb/auto'\nimport { afterEach, describe, expect, it, vi } from 'vitest'\nimport { getDatabase } from '$lib/db/database.ts'\nimport { clearDatabaseStores } from '$lib/helpers/test-helpers.ts'\nimport { dbAddToPlayHistory } from '$lib/library/play-history-actions.ts'\nimport { LEGACY_NO_NATIVE_DIRECTORY, type Track } from '$lib/library/types.ts'\n\nconst seedTrack = async (id: number) => {\n\tconst db = await getDatabase()\n\tconst trackData: Track = {\n\t\tid,\n\t\tuuid: `track-${id}`,\n\t\tname: `Track ${id}`,\n\t\tartists: ['Artist'],\n\t\talbum: 'Album',\n\t\tyear: '2026',\n\t\tduration: 180,\n\t\tgenre: [],\n\t\ttrackNo: 1,\n\t\ttrackOf: 1,\n\t\tdiscNo: 1,\n\t\tdiscOf: 1,\n\t\tfileName: `track-${id}.mp3`,\n\t\tdirectory: LEGACY_NO_NATIVE_DIRECTORY,\n\t\tscannedAt: Date.now(),\n\t\tfile: new File(['x'], `track-${id}.mp3`, { type: 'audio/mpeg' }),\n\t}\n\n\tawait db.add('tracks', trackData)\n}\n\ndescribe('play history actions', () => {\n\tafterEach(async () => {\n\t\tvi.restoreAllMocks()\n\t\tawait clearDatabaseStores()\n\t})\n\n\tit('keeps only one entry per track id', async () => {\n\t\tlet now = 100\n\t\tvi.spyOn(Date, 'now').mockImplementation(() => {\n\t\t\tnow += 1\n\t\t\treturn now\n\t\t})\n\n\t\tawait seedTrack(1)\n\t\tawait seedTrack(2)\n\n\t\tawait dbAddToPlayHistory(1)\n\t\tawait dbAddToPlayHistory(2)\n\t\tawait dbAddToPlayHistory(1)\n\n\t\tconst db = await getDatabase()\n\t\tconst entries = await db.getAllFromIndex('playHistory', 'playedAt')\n\n\t\texpect(entries).toHaveLength(2)\n\t\texpect(entries.filter((entry) => entry.trackId === 1)).toHaveLength(1)\n\t\texpect(entries.map((entry) => entry.trackId)).toEqual([2, 1])\n\t})\n\n\tit('does not increase history size when replaying the same track', async () => {\n\t\tlet now = 200\n\t\tvi.spyOn(Date, 'now').mockImplementation(() => {\n\t\t\tnow += 1\n\t\t\treturn now\n\t\t})\n\n\t\tawait seedTrack(10)\n\n\t\tawait dbAddToPlayHistory(10)\n\t\tawait dbAddToPlayHistory(10)\n\t\tawait dbAddToPlayHistory(10)\n\n\t\tconst db = await getDatabase()\n\t\tconst entries = await db.getAll('playHistory')\n\n\t\texpect(entries).toHaveLength(1)\n\t\texpect(entries[0]?.trackId).toBe(10)\n\t})\n\n\tit('keeps only the most recent 100 history entries', async () => {\n\t\tlet now = 300\n\t\tvi.spyOn(Date, 'now').mockImplementation(() => {\n\t\t\tnow += 1\n\t\t\treturn now\n\t\t})\n\n\t\tfor (let trackId = 1; trackId <= 120; trackId += 1) {\n\t\t\tawait seedTrack(trackId)\n\t\t\tawait dbAddToPlayHistory(trackId)\n\t\t}\n\n\t\tconst db = await getDatabase()\n\t\tconst entries = await db.getAllFromIndex('playHistory', 'playedAt')\n\t\tconst trackIds = entries.map((entry) => entry.trackId)\n\n\t\texpect(entries).toHaveLength(100)\n\t\texpect(trackIds[0]).toBe(21)\n\t\texpect(trackIds.at(-1)).toBe(120)\n\t\texpect(trackIds).not.toContain(20)\n\t})\n})\n"
},
{
"path": "src/lib/library/__tests__/playlists.test.ts",
"content": "import 'fake-indexeddb/auto'\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\nimport { getDatabase } from '$lib/db/database.ts'\nimport {\n\tclearDatabaseStores,\n\tdbGetAllAndExpectLength,\n\texpectToBeDefined,\n} from '$lib/helpers/test-helpers.ts'\nimport {\n\tcreatePlaylist,\n\tdbAddTracksToPlaylistsWithTx,\n\tdbBatchModifyPlaylistsSelection,\n\tdbCreatePlaylist,\n\tdbRemovePlaylist,\n\tdbRemoveTracksFromPlaylistsWithTx,\n\tgetPlaylistEntriesDatabaseStore,\n\tremoveTrackEntryFromPlaylist,\n\ttoggleFavoriteTrack,\n\ttype UpdatePlaylistOptions,\n\tupdatePlaylist,\n} from '$lib/library/playlists-actions.ts'\nimport { dbImportTrack } from '$lib/library/scan-actions/scanner/import-track.ts'\nimport { FAVORITE_PLAYLIST_ID, type UnknownTrack } from '$lib/library/types.ts'\n\nvi.mock('$lib/components/snackbar/snackbar', () => ({\n\tsnackbar: Object.assign(vi.fn(), {\n\t\tunexpectedError: vi.fn(),\n\t}),\n}))\n\nlet uuidCounter = 0\n\nvi.stubGlobal('crypto', {\n\trandomUUID: vi.fn(() => {\n\t\tuuidCounter += 1\n\t\treturn `test-uuid-${uuidCounter}`\n\t}),\n})\n\nvi.stubGlobal('Date', {\n\tnow: vi.fn(() => 1_234_567_890),\n})\n\nlet trackCounter = 0\n\nconst dbImportTestTrack = async (overrides: Partial = {}): Promise => {\n\ttrackCounter += 1\n\tconst trackData: UnknownTrack = {\n\t\tuuid: `test-track-uuid-${trackCounter}`,\n\t\tname: `Test Track ${trackCounter}`,\n\t\talbum: 'Test Album',\n\t\tartists: ['Test Artist'],\n\t\tyear: '2023',\n\t\tduration: 180,\n\t\ttrackNo: 1,\n\t\ttrackOf: 10,\n\t\tdiscNo: 1,\n\t\tdiscOf: 1,\n\t\tgenre: ['Rock'],\n\t\tfile: new File(['test'], 'test.mp3', { type: 'audio/mp3' }) as UnknownTrack['file'],\n\t\tscannedAt: Date.now(),\n\t\tfileName: `test-${trackCounter}.mp3`,\n\t\tdirectory: 1,\n\t\t...overrides,\n\t}\n\n\treturn await dbImportTrack(trackData, undefined)\n}\n\ndescribe('playlists', () => {\n\tbeforeEach(async () => {\n\t\tawait clearDatabaseStores()\n\t\ttrackCounter = 0\n\t\tuuidCounter = 0\n\t})\n\n\tafterEach(() => {\n\t\tvi.clearAllMocks()\n\t})\n\n\tdescribe('playlist creation', () => {\n\t\tit('creates new playlist with all fields', async () => {\n\t\t\tawait dbCreatePlaylist('Test Playlist', 'My description')\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [playlist] = await db.getAll('playlists')\n\n\t\t\texpect(playlist?.name).toBe('Test Playlist')\n\t\t\texpect(playlist?.description).toBe('My description')\n\t\t\texpect(playlist?.uuid).toBe('test-uuid-1')\n\t\t\texpect(playlist?.createdAt).toBe(1_234_567_890)\n\t\t})\n\t})\n\n\tdescribe('UI wrapper functions', () => {\n\t\tit('creates playlist via UI wrapper', async () => {\n\t\t\tawait createPlaylist('UI Playlist', 'Created via UI')\n\n\t\t\tawait dbGetAllAndExpectLength('playlists', 1)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [playlist] = await db.getAll('playlists')\n\n\t\t\texpectToBeDefined(playlist)\n\t\t\texpect(playlist.name).toBe('UI Playlist')\n\t\t\texpect(playlist.description).toBe('Created via UI')\n\t\t})\n\n\t\tit('removes track entry from playlist via UI action', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\t\t\tconst playlistId = await dbCreatePlaylist('Test Playlist', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlistId],\n\t\t\t\ttrackIds: [trackId],\n\t\t\t})\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [entry] = await db.getAll('playlistEntries')\n\t\t\texpectToBeDefined(entry)\n\n\t\t\tawait removeTrackEntryFromPlaylist(entry.id)\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\t\t})\n\t})\n\n\tdescribe('playlist updates', () => {\n\t\tit('updates playlist name and description', async () => {\n\t\t\tconst playlistId = await dbCreatePlaylist('Original Name', 'Original description')\n\n\t\t\tconst updateOptions: UpdatePlaylistOptions = {\n\t\t\t\tid: playlistId,\n\t\t\t\tname: 'Updated Name',\n\t\t\t\tdescription: 'Updated description',\n\t\t\t}\n\n\t\t\tconst result = await updatePlaylist(updateOptions)\n\n\t\t\texpect(result).toBe(true)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [playlist] = await db.getAll('playlists')\n\n\t\t\texpectToBeDefined(playlist)\n\t\t\texpect(playlist.name).toBe('Updated Name')\n\t\t\texpect(playlist.description).toBe('Updated description')\n\t\t\texpect(playlist.uuid).toBe('test-uuid-1')\n\t\t\texpect(playlist.createdAt).toBe(1_234_567_890)\n\t\t})\n\n\t\tit('fails to update non-existent playlist', async () => {\n\t\t\tconst updateOptions: UpdatePlaylistOptions = {\n\t\t\t\tid: 999,\n\t\t\t\tname: 'Non-existent',\n\t\t\t\tdescription: 'Should fail',\n\t\t\t}\n\n\t\t\tconst result = await updatePlaylist(updateOptions)\n\n\t\t\texpect(result).toBe(false)\n\t\t})\n\t})\n\n\tdescribe('playlist removal', () => {\n\t\tit('removes playlist and associated entries', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\t\t\tconst playlistId = await dbCreatePlaylist('Test Playlist', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlistId],\n\t\t\t\ttrackIds: [trackId],\n\t\t\t})\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 1)\n\n\t\t\tawait dbRemovePlaylist(playlistId)\n\n\t\t\tawait dbGetAllAndExpectLength('playlists', 0)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\t\t})\n\n\t\tit('removes only entries for specific playlist', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\t\t\tconst playlist1Id = await dbCreatePlaylist('Playlist 1', '')\n\t\t\tconst playlist2Id = await dbCreatePlaylist('Playlist 2', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlist1Id, playlist2Id],\n\t\t\t\ttrackIds: [trackId],\n\t\t\t})\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 2)\n\n\t\t\tawait dbRemovePlaylist(playlist1Id)\n\n\t\t\tawait dbGetAllAndExpectLength('playlists', 1)\n\t\t\tconst [remainingEntry] = await dbGetAllAndExpectLength('playlistEntries', 1)\n\t\t\texpectToBeDefined(remainingEntry)\n\t\t\texpect(remainingEntry.playlistId).toBe(playlist2Id)\n\t\t})\n\t})\n\n\tdescribe('playlist entries management', () => {\n\t\tit('adds tracks to multiple playlists', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2' })\n\t\t\tconst playlist1Id = await dbCreatePlaylist('Playlist 1', '')\n\t\t\tconst playlist2Id = await dbCreatePlaylist('Playlist 2', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tconst changes = await dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlist1Id, playlist2Id],\n\t\t\t\ttrackIds: [track1Id, track2Id],\n\t\t\t})\n\n\t\t\texpect(changes).toHaveLength(4)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 4)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst entries = await db.getAll('playlistEntries')\n\t\t\tconst playlist1Entries = entries.filter((e) => e.playlistId === playlist1Id)\n\t\t\tconst playlist2Entries = entries.filter((e) => e.playlistId === playlist2Id)\n\n\t\t\texpect(playlist1Entries).toHaveLength(2)\n\t\t\texpect(playlist2Entries).toHaveLength(2)\n\t\t})\n\n\t\tit('removes tracks from specific playlists', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2' })\n\t\t\tconst playlist1Id = await dbCreatePlaylist('Playlist 1', '')\n\t\t\tconst playlist2Id = await dbCreatePlaylist('Playlist 2', '')\n\n\t\t\tlet store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlist1Id, playlist2Id],\n\t\t\t\ttrackIds: [track1Id, track2Id],\n\t\t\t})\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 4)\n\n\t\t\tstore = await getPlaylistEntriesDatabaseStore()\n\t\t\tconst changes = await dbRemoveTracksFromPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlist1Id],\n\t\t\t\ttrackIds: [track1Id],\n\t\t\t})\n\n\t\t\texpect(changes).toHaveLength(1)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 3)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst entries = await db.getAll('playlistEntries')\n\t\t\tconst hasTrack1InPlaylist1 = entries.some(\n\t\t\t\t(e) => e.playlistId === playlist1Id && e.trackId === track1Id,\n\t\t\t)\n\t\t\texpect(hasTrack1InPlaylist1).toBe(false)\n\t\t})\n\n\t\tit('batch modifies playlist selections', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2' })\n\t\t\tconst playlist1Id = await dbCreatePlaylist('Playlist 1', '')\n\t\t\tconst playlist2Id = await dbCreatePlaylist('Playlist 2', '')\n\t\t\tconst playlist3Id = await dbCreatePlaylist('Playlist 3', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlist1Id],\n\t\t\t\ttrackIds: [track1Id, track2Id],\n\t\t\t})\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 2)\n\n\t\t\tconst result = await dbBatchModifyPlaylistsSelection({\n\t\t\t\ttrackIds: [track1Id, track2Id],\n\t\t\t\tplaylistsIdsAddTo: [playlist2Id, playlist3Id],\n\t\t\t\tplaylistsIdsRemoveFrom: [playlist1Id],\n\t\t\t})\n\n\t\t\texpect(result).toBe(true)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 4)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst entries = await db.getAll('playlistEntries')\n\t\t\tconst playlist1Entries = entries.filter((e) => e.playlistId === playlist1Id)\n\t\t\tconst playlist2Entries = entries.filter((e) => e.playlistId === playlist2Id)\n\t\t\tconst playlist3Entries = entries.filter((e) => e.playlistId === playlist3Id)\n\n\t\t\texpect(playlist1Entries).toHaveLength(0)\n\t\t\texpect(playlist2Entries).toHaveLength(2)\n\t\t\texpect(playlist3Entries).toHaveLength(2)\n\t\t})\n\n\t\tit('returns false when no changes are made', async () => {\n\t\t\tconst result = await dbBatchModifyPlaylistsSelection({\n\t\t\t\ttrackIds: [],\n\t\t\t\tplaylistsIdsAddTo: [],\n\t\t\t\tplaylistsIdsRemoveFrom: [],\n\t\t\t})\n\n\t\t\texpect(result).toBe(false)\n\t\t})\n\t})\n\n\tdescribe('favorites functionality', () => {\n\t\tit('adds track to favorites', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\n\t\t\tawait toggleFavoriteTrack(false, trackId)\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [entry] = await db.getAll('playlistEntries')\n\n\t\t\texpectToBeDefined(entry)\n\t\t\texpect(entry.playlistId).toBe(FAVORITE_PLAYLIST_ID)\n\t\t\texpect(entry.trackId).toBe(trackId)\n\t\t\texpect(entry.addedAt).toBe(1_234_567_890)\n\t\t})\n\n\t\tit('removes track from favorites', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\n\t\t\tawait toggleFavoriteTrack(false, trackId)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 1)\n\n\t\t\tawait toggleFavoriteTrack(true, trackId)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\t\t})\n\t})\n\n\tdescribe('playlist entries data structure', () => {\n\t\tit('creates entries with correct structure', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\t\t\tconst playlistId = await dbCreatePlaylist('Test Playlist', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlistId],\n\t\t\t\ttrackIds: [trackId],\n\t\t\t})\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst [entry] = await db.getAll('playlistEntries')\n\n\t\t\texpect(entry).toEqual({\n\t\t\t\tid: expect.any(Number),\n\t\t\t\tplaylistId,\n\t\t\t\ttrackId,\n\t\t\t\taddedAt: 1_234_567_890,\n\t\t\t})\n\t\t})\n\n\t\tit('maintains chronological order of entries', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2' })\n\t\t\tconst playlistId = await dbCreatePlaylist('Test Playlist', '')\n\n\t\t\tconst store = await getPlaylistEntriesDatabaseStore()\n\n\t\t\tvi.mocked(Date.now).mockReturnValueOnce(1000)\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlistId],\n\t\t\t\ttrackIds: [track1Id],\n\t\t\t})\n\n\t\t\tvi.mocked(Date.now).mockReturnValueOnce(2000)\n\t\t\tawait dbAddTracksToPlaylistsWithTx(store, {\n\t\t\t\tplaylistIds: [playlistId],\n\t\t\t\ttrackIds: [track2Id],\n\t\t\t})\n\n\t\t\tconst db = await getDatabase()\n\t\t\tconst entries = await db.getAll('playlistEntries')\n\t\t\tentries.sort((a, b) => a.addedAt - b.addedAt)\n\n\t\t\texpect(entries).toHaveLength(2)\n\t\t\texpect(entries[0]?.trackId).toBe(track1Id)\n\t\t\texpect(entries[0]?.addedAt).toBe(1000)\n\t\t\texpect(entries[1]?.trackId).toBe(track2Id)\n\t\t\texpect(entries[1]?.addedAt).toBe(2000)\n\t\t})\n\t})\n})\n"
},
{
"path": "src/lib/library/__tests__/remove.test.ts",
"content": "import 'fake-indexeddb/auto'\nimport { beforeEach, describe, expect, it } from 'vitest'\nimport { getDatabase } from '$lib/db/database.ts'\nimport {\n\tclearDatabaseStores,\n\tdbGetAllAndExpectLength,\n\texpectToBeDefined,\n} from '$lib/helpers/test-helpers.ts'\nimport { dbAddToPlayHistory } from '$lib/library/play-history-actions.ts'\nimport { dbCreatePlaylist } from '$lib/library/playlists-actions.ts'\nimport { dbRemoveAlbum, dbRemoveArtist, dbRemoveTracks } from '$lib/library/remove.ts'\nimport { dbImportTrack } from '$lib/library/scan-actions/scanner/import-track.ts'\nimport type { PlaylistEntry, UnknownTrack } from '$lib/library/types.ts'\n\nconst dbImportTestTrack = (overrides: Partial = {}): Promise => {\n\tconst trackData: UnknownTrack = {\n\t\tuuid: crypto.randomUUID(),\n\t\tname: 'Test Track',\n\t\talbum: 'Test Album',\n\t\tartists: ['Test Artist'],\n\t\tyear: '2023',\n\t\tduration: 180,\n\t\ttrackNo: 1,\n\t\ttrackOf: 10,\n\t\tdiscNo: 1,\n\t\tdiscOf: 1,\n\t\tgenre: ['Rock'],\n\t\tfile: new File(['test'], 'test.mp3', { type: 'audio/mp3' }),\n\t\tscannedAt: Date.now(),\n\t\tfileName: 'test.mp3',\n\t\tdirectory: 1,\n\t\t...overrides,\n\t}\n\n\treturn dbImportTrack(trackData, undefined)\n}\n\nconst createTestPlaylist = async (name = 'Test Playlist'): Promise =>\n\tdbCreatePlaylist(name, '')\n\nconst addTrackToPlaylist = async (playlistId: number, trackId: number): Promise => {\n\tconst db = await getDatabase()\n\tconst playlistEntry: Omit = {\n\t\tplaylistId,\n\t\ttrackId,\n\t\taddedAt: Date.now(),\n\t}\n\tawait db.add('playlistEntries', playlistEntry as PlaylistEntry)\n}\n\nconst addTracksToPlaylist = async (\n\tplaylistId: number,\n\ttrackIds: readonly number[],\n): Promise => {\n\tfor (const trackId of trackIds) {\n\t\tawait addTrackToPlaylist(playlistId, trackId)\n\t}\n}\n\nconst addTracksToPlayHistory = async (trackIds: readonly number[]): Promise => {\n\tfor (const trackId of trackIds) {\n\t\tawait dbAddToPlayHistory(trackId)\n\t}\n}\n\nconst expectOnlyTrackWithReferences = async (trackId: number): Promise => {\n\tconst tracksAfter = await dbGetAllAndExpectLength('tracks', 1)\n\texpect(tracksAfter[0]?.id).toBe(trackId)\n\n\tconst playlistEntriesAfter = await dbGetAllAndExpectLength('playlistEntries', 1)\n\texpect(playlistEntriesAfter[0]?.trackId).toBe(trackId)\n\n\tconst playHistoryAfter = await dbGetAllAndExpectLength('playHistory', 1)\n\texpect(playHistoryAfter[0]?.trackId).toBe(trackId)\n}\n\ndescribe('remove functions', () => {\n\tbeforeEach(async () => {\n\t\tawait clearDatabaseStores()\n\t})\n\n\tdescribe('dbRemoveTracks', () => {\n\t\tit('should remove a track and clean up unused album and artist', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\n\t\t\tconst db = await getDatabase()\n\n\t\t\t// Verify track, album, and artist were created\n\t\t\tawait dbGetAllAndExpectLength('tracks', 1)\n\n\t\t\tconst albums = await dbGetAllAndExpectLength('albums', 1)\n\t\t\texpect(albums[0]?.name).toBe('Test Album')\n\n\t\t\tconst artists = await dbGetAllAndExpectLength('artists', 1)\n\t\t\texpect(artists[0]?.name).toBe('Test Artist')\n\n\t\t\t// Remove the track\n\t\t\tawait dbRemoveTracks([trackId])\n\n\t\t\t// Verify track is removed\n\t\t\tconst removedTrack = await db.get('tracks', trackId)\n\t\t\texpect(removedTrack).toBeUndefined()\n\n\t\t\t// Verify album and artist are also removed (cleanup)\n\t\t\tawait dbGetAllAndExpectLength('albums', 0)\n\t\t\tawait dbGetAllAndExpectLength('artists', 0)\n\t\t})\n\n\t\tit('should not remove album or artist if still referenced by other tracks', async () => {\n\t\t\t// Create two tracks with the same album and artist\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2' })\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 2)\n\t\t\tawait dbGetAllAndExpectLength('albums', 1)\n\t\t\tawait dbGetAllAndExpectLength('artists', 1)\n\n\t\t\tawait dbRemoveTracks([track1Id])\n\n\t\t\t// Verify only one track is removed\n\t\t\tconst tracksAfter = await dbGetAllAndExpectLength('tracks', 1)\n\t\t\texpect(tracksAfter[0]?.id).toBe(track2Id)\n\n\t\t\t// Verify album and artist are still there\n\t\t\tawait dbGetAllAndExpectLength('albums', 1)\n\t\t\tawait dbGetAllAndExpectLength('artists', 1)\n\t\t})\n\n\t\tit('should remove track from all playlists when removing the track', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\n\t\t\tconst playlistId1 = await createTestPlaylist('Test Playlist 1')\n\t\t\tconst playlistId2 = await createTestPlaylist('Test Playlist 2')\n\n\t\t\tawait dbGetAllAndExpectLength('playlists', 2)\n\t\t\tawait addTracksToPlaylist(playlistId1, [trackId])\n\t\t\tawait addTracksToPlaylist(playlistId2, [trackId])\n\n\t\t\tconst playlistEntries = await dbGetAllAndExpectLength('playlistEntries', 2)\n\t\t\texpect(playlistEntries.every((entry) => entry.trackId === trackId)).toBe(true)\n\n\t\t\tawait dbRemoveTracks([trackId])\n\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\n\t\t\tawait dbGetAllAndExpectLength('playlists', 2)\n\t\t})\n\n\t\tit('should remove deleted tracks from play history and keep unrelated entries', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({ name: 'Track 2', album: 'Album 2' })\n\n\t\t\tawait dbAddToPlayHistory(track1Id)\n\t\t\tawait dbAddToPlayHistory(track2Id)\n\n\t\t\tawait dbGetAllAndExpectLength('playHistory', 2)\n\n\t\t\tawait dbRemoveTracks([track1Id])\n\n\t\t\tconst historyEntries = await dbGetAllAndExpectLength('playHistory', 1)\n\t\t\texpect(historyEntries[0]?.trackId).toBe(track2Id)\n\t\t})\n\n\t\tit('should handle removing non-existent track gracefully', async () => {\n\t\t\t// Try to remove a track that doesn't exist\n\t\t\tawait expect(dbRemoveTracks([999])).resolves.toBeUndefined()\n\t\t})\n\n\t\tit('should ignore duplicate track ids in one removal request', async () => {\n\t\t\tconst trackId = await dbImportTestTrack()\n\n\t\t\tconst playlistId = await createTestPlaylist()\n\n\t\t\tawait addTracksToPlaylist(playlistId, [trackId, trackId])\n\t\t\tawait addTracksToPlayHistory([trackId])\n\n\t\t\tawait dbRemoveTracks([trackId, trackId])\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 0)\n\t\t\tawait dbGetAllAndExpectLength('albums', 0)\n\t\t\tawait dbGetAllAndExpectLength('artists', 0)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\t\t\tawait dbGetAllAndExpectLength('playHistory', 0)\n\t\t})\n\n\t\tit('should remove existing tracks and ignore missing ids in the same request', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst track2Id = await dbImportTestTrack({\n\t\t\t\tname: 'Track 2',\n\t\t\t\talbum: 'Album 2',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t})\n\n\t\t\tconst playlistId = await createTestPlaylist()\n\n\t\t\tawait addTracksToPlaylist(playlistId, [track1Id, track2Id])\n\t\t\tawait addTracksToPlayHistory([track1Id, track2Id])\n\n\t\t\tawait dbRemoveTracks([track1Id, 999])\n\n\t\t\tawait expectOnlyTrackWithReferences(track2Id)\n\n\t\t\tconst albumsAfter = await dbGetAllAndExpectLength('albums', 1)\n\t\t\texpect(albumsAfter[0]?.name).toBe('Album 2')\n\n\t\t\tconst artistsAfter = await dbGetAllAndExpectLength('artists', 1)\n\t\t\texpect(artistsAfter[0]?.name).toBe('Artist 2')\n\t\t})\n\n\t\tit('should remove multiple tracks in one operation and clean up shared data once unused', async () => {\n\t\t\tconst track1Id = await dbImportTestTrack({ name: 'Track 1', artists: ['Artist 1'] })\n\t\t\tconst track2Id = await dbImportTestTrack({\n\t\t\t\tname: 'Track 2',\n\t\t\t\talbum: 'Album 2',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t})\n\n\t\t\tconst playlistId = await createTestPlaylist()\n\n\t\t\tawait addTracksToPlaylist(playlistId, [track1Id, track2Id])\n\n\t\t\tawait dbRemoveTracks([track1Id, track2Id])\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 0)\n\t\t\tawait dbGetAllAndExpectLength('albums', 0)\n\t\t\tawait dbGetAllAndExpectLength('artists', 0)\n\t\t\tawait dbGetAllAndExpectLength('playlistEntries', 0)\n\t\t\tawait dbGetAllAndExpectLength('playlists', 1)\n\t\t})\n\n\t\tit('should return early for empty input', async () => {\n\t\t\tawait expect(dbRemoveTracks([])).resolves.toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('dbRemoveAlbum', () => {\n\t\tit('should remove album and all its tracks', async () => {\n\t\t\t// Create two tracks with the same album\n\t\t\tawait dbImportTestTrack({ name: 'Track 1' })\n\t\t\tawait dbImportTestTrack({ name: 'Track 2' })\n\n\t\t\tconst albums = await dbGetAllAndExpectLength('albums', 1)\n\t\t\tconst albumId = albums[0]?.id\n\t\t\texpectToBeDefined(albumId)\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 2)\n\n\t\t\tawait dbRemoveAlbum(albumId)\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 0)\n\t\t\tawait dbGetAllAndExpectLength('albums', 0)\n\t\t})\n\n\t\tit('should handle removing non-existent album gracefully', async () => {\n\t\t\t// Try to remove an album that doesn't exist\n\t\t\tawait expect(dbRemoveAlbum(999)).resolves.toBeUndefined()\n\t\t})\n\n\t\tit('should clear playlists and play history for removed album tracks only', async () => {\n\t\t\tconst albumTrack1Id = await dbImportTestTrack({ name: 'Track 1' })\n\t\t\tconst albumTrack2Id = await dbImportTestTrack({ name: 'Track 2' })\n\t\t\tconst survivorTrackId = await dbImportTestTrack({\n\t\t\t\tname: 'Track 3',\n\t\t\t\talbum: 'Album 2',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t})\n\n\t\t\tconst playlistId = await createTestPlaylist()\n\n\t\t\tawait addTracksToPlaylist(playlistId, [albumTrack1Id, albumTrack2Id, survivorTrackId])\n\n\t\t\tawait addTracksToPlayHistory([albumTrack1Id, albumTrack2Id, survivorTrackId])\n\n\t\t\tconst albums = await dbGetAllAndExpectLength('albums', 2)\n\t\t\tconst albumId = albums.find((album) => album.name === 'Test Album')?.id\n\t\t\texpectToBeDefined(albumId)\n\n\t\t\tawait dbRemoveAlbum(albumId)\n\n\t\t\tawait expectOnlyTrackWithReferences(survivorTrackId)\n\t\t})\n\n\t\tit('should keep shared artists that are still referenced by survivor tracks from other albums', async () => {\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Album Track 1',\n\t\t\t\talbum: 'Album 1',\n\t\t\t\tartists: ['Shared Artist', 'Album 1 Artist'],\n\t\t\t})\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Album Track 2',\n\t\t\t\talbum: 'Album 1',\n\t\t\t\tartists: ['Shared Artist'],\n\t\t\t})\n\t\t\tconst survivorTrackId = await dbImportTestTrack({\n\t\t\t\tname: 'Survivor Track',\n\t\t\t\talbum: 'Album 2',\n\t\t\t\tartists: ['Shared Artist', 'Album 2 Artist'],\n\t\t\t})\n\n\t\t\tconst albums = await dbGetAllAndExpectLength('albums', 2)\n\t\t\tconst albumId = albums.find((album) => album.name === 'Album 1')?.id\n\t\t\texpectToBeDefined(albumId)\n\n\t\t\tawait dbRemoveAlbum(albumId)\n\n\t\t\tconst tracksAfter = await dbGetAllAndExpectLength('tracks', 1)\n\t\t\texpect(tracksAfter[0]?.id).toBe(survivorTrackId)\n\n\t\t\tconst albumsAfter = await dbGetAllAndExpectLength('albums', 1)\n\t\t\texpect(albumsAfter[0]?.name).toBe('Album 2')\n\n\t\t\tconst artistsAfter = await dbGetAllAndExpectLength('artists', 2)\n\t\t\texpect(artistsAfter.map((artist) => artist.name).sort()).toEqual([\n\t\t\t\t'Album 2 Artist',\n\t\t\t\t'Shared Artist',\n\t\t\t])\n\t\t})\n\t})\n\n\tdescribe('dbRemoveArtist', () => {\n\t\tit('should remove artist and all tracks by that artist', async () => {\n\t\t\t// Create two tracks with the same artist\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Track 1',\n\t\t\t\talbum: 'Album 1',\n\t\t\t})\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Track 2',\n\t\t\t\talbum: 'Album 2',\n\t\t\t})\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 2)\n\t\t\tconst artists = await dbGetAllAndExpectLength('artists', 1)\n\t\t\tconst artistId = artists[0]?.id\n\t\t\texpectToBeDefined(artistId)\n\n\t\t\tawait dbRemoveArtist(artistId)\n\n\t\t\tawait dbGetAllAndExpectLength('tracks', 0)\n\t\t\tawait dbGetAllAndExpectLength('artists', 0)\n\t\t})\n\n\t\tit('should handle removing non-existent artist gracefully', async () => {\n\t\t\tawait expect(dbRemoveArtist(999)).resolves.toBeUndefined()\n\t\t})\n\n\t\tit('should remove tracks with multiple artists correctly', async () => {\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tartists: ['Artist 1', 'Artist 2'],\n\t\t\t\talbum: 'Collaboration Album',\n\t\t\t})\n\t\t\t// Another track with only one of the artists\n\t\t\tconst track2Id = await dbImportTestTrack({\n\t\t\t\tname: 'Track 2',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t\talbum: 'Solo Album',\n\t\t\t})\n\n\t\t\tconst artists = await dbGetAllAndExpectLength('artists', 2)\n\n\t\t\tconst artist1 = artists.find((a) => a.name === 'Artist 1')\n\t\t\texpectToBeDefined(artist1?.id)\n\n\t\t\tawait dbRemoveArtist(artist1.id)\n\n\t\t\tconst tracksAfter = await dbGetAllAndExpectLength('tracks', 1)\n\t\t\texpect(tracksAfter[0]?.id, 'Expected Track 2 to remain').toBe(track2Id)\n\n\t\t\tconst artistsAfter = await dbGetAllAndExpectLength('artists', 1)\n\t\t\texpect(artistsAfter[0]?.name, 'Expected Artist 2 to remain').toBe('Artist 2')\n\t\t})\n\n\t\tit('should clear playlists and play history for removed artist tracks only', async () => {\n\t\t\tconst artistTrack1Id = await dbImportTestTrack({\n\t\t\t\tname: 'Track 1',\n\t\t\t\talbum: 'Album 1',\n\t\t\t\tartists: ['Artist 1'],\n\t\t\t})\n\t\t\tconst artistTrack2Id = await dbImportTestTrack({\n\t\t\t\tname: 'Track 2',\n\t\t\t\talbum: 'Album 2',\n\t\t\t\tartists: ['Artist 1'],\n\t\t\t})\n\t\t\tconst survivorTrackId = await dbImportTestTrack({\n\t\t\t\tname: 'Track 3',\n\t\t\t\talbum: 'Album 3',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t})\n\n\t\t\tconst playlistId = await createTestPlaylist()\n\n\t\t\tawait addTracksToPlaylist(playlistId, [artistTrack1Id, artistTrack2Id, survivorTrackId])\n\n\t\t\tawait addTracksToPlayHistory([artistTrack1Id, artistTrack2Id, survivorTrackId])\n\n\t\t\tconst artists = await dbGetAllAndExpectLength('artists', 2)\n\t\t\tconst artistId = artists.find((artist) => artist.name === 'Artist 1')?.id\n\t\t\texpectToBeDefined(artistId)\n\n\t\t\tawait dbRemoveArtist(artistId)\n\n\t\t\tawait expectOnlyTrackWithReferences(survivorTrackId)\n\t\t})\n\n\t\tit('should keep shared albums that are still referenced by survivor tracks from other artists', async () => {\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Artist 1 Track 1',\n\t\t\t\talbum: 'Shared Album',\n\t\t\t\tartists: ['Artist 1'],\n\t\t\t})\n\t\t\tawait dbImportTestTrack({\n\t\t\t\tname: 'Artist 1 Track 2',\n\t\t\t\talbum: 'Artist 1 Album',\n\t\t\t\tartists: ['Artist 1'],\n\t\t\t})\n\t\t\tconst survivorTrackId = await dbImportTestTrack({\n\t\t\t\tname: 'Artist 2 Survivor',\n\t\t\t\talbum: 'Shared Album',\n\t\t\t\tartists: ['Artist 2'],\n\t\t\t})\n\n\t\t\tconst artists = await dbGetAllAndExpectLength('artists', 2)\n\t\t\tconst artistId = artists.find((artist) => artist.name === 'Artist 1')?.id\n\t\t\texpectToBeDefined(artistId)\n\n\t\t\tawait dbRemoveArtist(artistId)\n\n\t\t\tconst tracksAfter = await dbGetAllAndExpectLength('tracks', 1)\n\t\t\texpect(tracksAfter[0]?.id).toBe(survivorTrackId)\n\n\t\t\tconst albumsAfter = await dbGetAllAndExpectLength('albums', 1)\n\t\t\texpect(albumsAfter[0]?.name).toBe('Shared Album')\n\n\t\t\tconst artistsAfter = await dbGetAllAndExpectLength('artists', 1)\n\t\t\texpect(artistsAfter[0]?.name).toBe('Artist 2')\n\t\t})\n\t})\n})\n"
},
{
"path": "src/lib/library/get/__tests__/value.test.ts",
"content": "import 'fake-indexeddb/auto'\nimport { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'\nimport { getDatabase } from '$lib/db/database.ts'\nimport type { DatabaseChangeDetails } from '$lib/db/events.ts'\nimport { clearDatabaseStores } from '$lib/helpers/test-helpers.ts'\nimport {\n\tclearLibraryValueCache,\n\tgetLibraryValue,\n\tLibraryValueNotFoundError,\n\tpreloadLibraryValue,\n\tshouldRefetchLibraryValue,\n} from '$lib/library/get/value.ts'\nimport { FAVORITE_PLAYLIST_ID, FAVORITE_PLAYLIST_UUID } from '$lib/library/types.ts'\n\n// Mock crypto.randomUUID for consistent UUIDs\nvi.stubGlobal('crypto', {\n\trandomUUID: vi.fn(() => 'test-uuid-123'),\n})\n\n// Mock Date.now for consistent timestamps\nvi.stubGlobal('Date', {\n\tnow: vi.fn(() => 1_234_567_890),\n})\n\ndescribe('getLibraryValue', () => {\n\tbeforeEach(async () => {\n\t\tawait clearDatabaseStores()\n\t\tclearLibraryValueCache()\n\t})\n\n\tafterEach(() => {\n\t\tvi.clearAllMocks()\n\t})\n\n\tdescribe('tracks', () => {\n\t\tit('should return track data with favorite status false', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\t// Insert a track\n\t\t\tconst trackData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Track',\n\t\t\t\talbum: 'Test Album',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tuuid: 'track-uuid-1',\n\t\t\t\tyear: '2023',\n\t\t\t\tduration: 180,\n\t\t\t\tgenre: ['Rock'],\n\t\t\t\ttrackNo: 1,\n\t\t\t\ttrackOf: 10,\n\t\t\t\tdiscNo: 1,\n\t\t\t\tdiscOf: 1,\n\t\t\t\tfile: {} as File,\n\t\t\t\tscannedAt: 1_234_567_890,\n\t\t\t\tfileName: 'test-track.mp3',\n\t\t\t\tdirectory: 1,\n\t\t\t}\n\n\t\t\tawait db.add('tracks', trackData)\n\n\t\t\tconst result = await getLibraryValue('tracks', 1)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\t...trackData,\n\t\t\t\ttype: 'track',\n\t\t\t\tfavorite: false,\n\t\t\t})\n\t\t})\n\n\t\tit('should return track data with favorite status true when track is in favorites', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\t// Insert a track\n\t\t\tconst trackData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Track',\n\t\t\t\talbum: 'Test Album',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tuuid: 'track-uuid-1',\n\t\t\t\tyear: '2023',\n\t\t\t\tduration: 180,\n\t\t\t\tgenre: ['Rock'],\n\t\t\t\ttrackNo: 1,\n\t\t\t\ttrackOf: 10,\n\t\t\t\tdiscNo: 1,\n\t\t\t\tdiscOf: 1,\n\t\t\t\tfile: {} as File,\n\t\t\t\tscannedAt: 1_234_567_890,\n\t\t\t\tfileName: 'test-track.mp3',\n\t\t\t\tdirectory: 1,\n\t\t\t}\n\n\t\t\tawait db.add('tracks', trackData)\n\n\t\t\t// Add track to favorites\n\t\t\tawait db.add('playlistEntries', {\n\t\t\t\tid: 1,\n\t\t\t\tplaylistId: FAVORITE_PLAYLIST_ID,\n\t\t\t\ttrackId: 1,\n\t\t\t\taddedAt: 1_234_567_890,\n\t\t\t})\n\n\t\t\tconst result = await getLibraryValue('tracks', 1)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\t...trackData,\n\t\t\t\ttype: 'track',\n\t\t\t\tfavorite: true,\n\t\t\t})\n\t\t})\n\n\t\tit('should throw LibraryValueNotFoundError for non-existent track', async () => {\n\t\t\tawait expect(getLibraryValue('tracks', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t})\n\n\t\tit('should return undefined for non-existent track when allowEmpty is true', async () => {\n\t\t\tconst result = await getLibraryValue('tracks', 999, true)\n\t\t\texpect(result).toBeUndefined()\n\t\t})\n\n\t\tit('should return cached value on subsequent calls', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst trackData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Track',\n\t\t\t\talbum: 'Test Album',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tuuid: 'track-uuid-1',\n\t\t\t\tyear: '2023',\n\t\t\t\tduration: 180,\n\t\t\t\tgenre: ['Rock'],\n\t\t\t\ttrackNo: 1,\n\t\t\t\ttrackOf: 10,\n\t\t\t\tdiscNo: 1,\n\t\t\t\tdiscOf: 1,\n\t\t\t\tfile: {} as File,\n\t\t\t\tscannedAt: 1_234_567_890,\n\t\t\t\tfileName: 'test-track.mp3',\n\t\t\t\tdirectory: 1,\n\t\t\t}\n\n\t\t\tawait db.add('tracks', trackData)\n\n\t\t\t// First call - should fetch from database\n\t\t\tconst result1 = await getLibraryValue('tracks', 1)\n\n\t\t\t// Second call - should return cached value\n\t\t\tconst result2 = await getLibraryValue('tracks', 1)\n\n\t\t\texpect(result1).toEqual(result2)\n\t\t})\n\t})\n\n\tdescribe('albums', () => {\n\t\tit('should return album data', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst albumData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Album',\n\t\t\t\tuuid: 'album-uuid-1',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tyear: '2023',\n\t\t\t\timage: {} as Blob,\n\t\t\t}\n\n\t\t\tawait db.add('albums', albumData)\n\n\t\t\tconst result = await getLibraryValue('albums', 1)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\t...albumData,\n\t\t\t\ttype: 'album',\n\t\t\t})\n\t\t})\n\n\t\tit('should throw LibraryValueNotFoundError for non-existent album', async () => {\n\t\t\tawait expect(getLibraryValue('albums', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t})\n\n\t\tit('should return undefined for non-existent album when allowEmpty is true', async () => {\n\t\t\tconst result = await getLibraryValue('albums', 999, true)\n\t\t\texpect(result).toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('artists', () => {\n\t\tit('should return artist data', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst artistData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Artist',\n\t\t\t\tuuid: 'artist-uuid-1',\n\t\t\t}\n\n\t\t\tawait db.add('artists', artistData)\n\n\t\t\tconst result = await getLibraryValue('artists', 1)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\t...artistData,\n\t\t\t\ttype: 'artist',\n\t\t\t})\n\t\t})\n\n\t\tit('should throw LibraryValueNotFoundError for non-existent artist', async () => {\n\t\t\tawait expect(getLibraryValue('artists', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t})\n\n\t\tit('should return undefined for non-existent artist when allowEmpty is true', async () => {\n\t\t\tconst result = await getLibraryValue('artists', 999, true)\n\t\t\texpect(result).toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('playlists', () => {\n\t\tit('should return playlist data', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst playlistData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Playlist',\n\t\t\t\tdescription: '',\n\t\t\t\tuuid: 'playlist-uuid-1',\n\t\t\t\tcreatedAt: 1_234_567_890,\n\t\t\t}\n\n\t\t\tawait db.add('playlists', playlistData)\n\n\t\t\tconst result = await getLibraryValue('playlists', 1)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\t...playlistData,\n\t\t\t\ttype: 'playlist',\n\t\t\t})\n\t\t})\n\n\t\tit('should return favorite playlist for FAVORITE_PLAYLIST_ID', async () => {\n\t\t\tconst result = await getLibraryValue('playlists', FAVORITE_PLAYLIST_ID)\n\n\t\t\texpect(result).toEqual({\n\t\t\t\ttype: 'playlist',\n\t\t\t\tid: FAVORITE_PLAYLIST_ID,\n\t\t\t\tuuid: FAVORITE_PLAYLIST_UUID,\n\t\t\t\tdescription: '',\n\t\t\t\tname: 'Favorites',\n\t\t\t\tcreatedAt: 0,\n\t\t\t})\n\t\t})\n\n\t\tit('should throw LibraryValueNotFoundError for non-existent playlist', async () => {\n\t\t\tawait expect(getLibraryValue('playlists', 999)).rejects.toThrow(\n\t\t\t\tLibraryValueNotFoundError,\n\t\t\t)\n\t\t})\n\n\t\tit('should return undefined for non-existent playlist when allowEmpty is true', async () => {\n\t\t\tconst result = await getLibraryValue('playlists', 999, true)\n\t\t\texpect(result).toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('preloadLibraryValue', () => {\n\t\tit('should preload track value into cache', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst trackData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Track',\n\t\t\t\talbum: 'Test Album',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tuuid: 'track-uuid-1',\n\t\t\t\tyear: '2023',\n\t\t\t\tduration: 180,\n\t\t\t\tgenre: ['Rock'],\n\t\t\t\ttrackNo: 1,\n\t\t\t\ttrackOf: 10,\n\t\t\t\tdiscNo: 1,\n\t\t\t\tdiscOf: 1,\n\t\t\t\tfile: {} as File,\n\t\t\t\tscannedAt: 1_234_567_890,\n\t\t\t\tfileName: 'test-track.mp3',\n\t\t\t\tdirectory: 1,\n\t\t\t}\n\n\t\t\tawait db.add('tracks', trackData)\n\n\t\t\t// Preload the value\n\t\t\tawait preloadLibraryValue('tracks', 1)\n\n\t\t\t// This should now return synchronously from cache\n\t\t\tconst result = getLibraryValue('tracks', 1)\n\n\t\t\t// If it's synchronous, it should not be a Promise\n\t\t\texpect(result).not.toBeInstanceOf(Promise)\n\t\t\texpect(result).toEqual({\n\t\t\t\t...trackData,\n\t\t\t\ttype: 'track',\n\t\t\t\tfavorite: false,\n\t\t\t})\n\t\t})\n\n\t\tit('should not throw error for non-existent value', async () => {\n\t\t\t// Should not throw even though the value doesn't exist\n\t\t\tawait expect(preloadLibraryValue('tracks', 999)).resolves.toBeUndefined()\n\t\t})\n\t})\n\n\tdescribe('shouldRefetchLibraryValue', () => {\n\t\tit('should return true when track is updated', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'tracks',\n\t\t\t\t\toperation: 'update',\n\t\t\t\t\tkey: 1,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('tracks', 1, changes)\n\t\t\texpect(result).toBe(true)\n\t\t})\n\n\t\tit('should return true when track favorite status changes', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'playlistEntries',\n\t\t\t\t\toperation: 'add',\n\t\t\t\t\tkey: 1,\n\t\t\t\t\tvalue: {\n\t\t\t\t\t\tid: 1,\n\t\t\t\t\t\tplaylistId: FAVORITE_PLAYLIST_ID,\n\t\t\t\t\t\ttrackId: 1,\n\t\t\t\t\t\taddedAt: 1_234_567_890,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('tracks', 1, changes)\n\t\t\texpect(result).toBe(true)\n\t\t})\n\n\t\tit('should return false when unrelated changes occur', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'tracks',\n\t\t\t\t\toperation: 'update',\n\t\t\t\t\tkey: 2,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('tracks', 1, changes)\n\t\t\texpect(result).toBe(false)\n\t\t})\n\n\t\tit('should return true when album is updated', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'albums',\n\t\t\t\t\toperation: 'update',\n\t\t\t\t\tkey: 1,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('albums', 1, changes)\n\t\t\texpect(result).toBe(true)\n\t\t})\n\n\t\tit('should return true when artist is deleted', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'artists',\n\t\t\t\t\toperation: 'delete',\n\t\t\t\t\tkey: 1,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('artists', 1, changes)\n\t\t\texpect(result).toBe(true)\n\t\t})\n\n\t\tit('should return true when playlist is updated', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'playlists',\n\t\t\t\t\toperation: 'update',\n\t\t\t\t\tkey: 1,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('playlists', 1, changes)\n\t\t\texpect(result).toBe(true)\n\t\t})\n\n\t\tit('should return false when no relevant changes occur', () => {\n\t\t\tconst changes: readonly DatabaseChangeDetails[] = [\n\t\t\t\t{\n\t\t\t\t\tstoreName: 'albums',\n\t\t\t\t\toperation: 'update',\n\t\t\t\t\tkey: 2,\n\t\t\t\t},\n\t\t\t]\n\n\t\t\tconst result = shouldRefetchLibraryValue('tracks', 1, changes)\n\t\t\texpect(result).toBe(false)\n\t\t})\n\t})\n\n\tdescribe('LibraryValueNotFoundError', () => {\n\t\tit('should have correct message and name', () => {\n\t\t\tconst error = new LibraryValueNotFoundError('tracks:1')\n\n\t\t\texpect(error.message).toBe('Value not found. Cache key: tracks:1')\n\t\t\texpect(error.name).toBe('LibraryValueNotFoundError')\n\t\t\texpect(error).toBeInstanceOf(Error)\n\t\t})\n\t})\n\n\tdescribe('concurrent access', () => {\n\t\tit('should handle concurrent requests for same value', async () => {\n\t\t\tconst db = await getDatabase()\n\n\t\t\tconst trackData = {\n\t\t\t\tid: 1,\n\t\t\t\tname: 'Test Track',\n\t\t\t\talbum: 'Test Album',\n\t\t\t\tartists: ['Test Artist'],\n\t\t\t\tuuid: 'track-uuid-1',\n\t\t\t\tyear: '2023',\n\t\t\t\tduration: 180,\n\t\t\t\tgenre: ['Rock'],\n\t\t\t\ttrackNo: 1,\n\t\t\t\ttrackOf: 10,\n\t\t\t\tdiscNo: 1,\n\t\t\t\tdiscOf: 1,\n\t\t\t\tfile: {} as File,\n\t\t\t\tscannedAt: 1_234_567_890,\n\t\t\t\tfileName: 'test-track.mp3',\n\t\t\t\tdirectory: 1,\n\t\t\t}\n\n\t\t\tawait db.add('tracks', trackData)\n\n\t\t\t// Make multiple concurrent requests\n\t\t\tconst promises = [\n\t\t\t\tgetLibraryValue('tracks', 1),\n\t\t\t\tgetLibraryValue('tracks', 1),\n\t\t\t\tgetLibraryValue('tracks', 1),\n\t\t\t]\n\n\t\t\tconst results = await Promise.all(promises)\n\n\t\t\t// All results should be identical\n\t\t\texpect(results[0]).toEqual(results[1])\n\t\t\texpect(results[1]).toEqual(results[2])\n\t\t\texpect(results[0]).toEqual({\n\t\t\t\t...trackData,\n\t\t\t\ttype: 'track',\n\t\t\t\tfavorite: false,\n\t\t\t})\n\t\t})\n\t})\n\n\tdescribe('error handling', () => {\n\t\tit('should handle LibraryValueNotFoundError correctly', async () => {\n\t\t\tawait expect(getLibraryValue('tracks', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t\tawait expect(getLibraryValue('albums', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t\tawait expect(getLibraryValue('artists', 999)).rejects.toThrow(LibraryValueNotFoundError)\n\t\t\tawait expect(getLibraryValue('playlists', 999)).rejects.toThrow(\n\t\t\t\tLibraryValueNotFoundError,\n\t\t\t)\n\t\t})\n\t})\n})\n"
},
{
"path": "src/lib/library/get/ids-queries.ts",
"content": "import type { DatabaseChangeDetailsList } from '$lib/db/events.ts'\nimport type { DbChangeActions } from '$lib/db/query/base-query.svelte.ts'\nimport {\n\tcreatePageQuery,\n\ttype PageQueryOptions,\n\ttype PageQueryResult,\n\ttype QueryKey,\n} from '$lib/db/query/page-query.svelte.ts'\nimport type { LibraryStoreName } from '../types.ts'\nimport { preloadLibraryValue } from './value.ts'\n\nexport type { PageQueryResult } from '$lib/db/query/page-query.svelte.ts'\nexport type { QueryResult } from '$lib/db/query/query.ts'\n\nconst preloadLimit = 12\n\nconst preloadLibraryListValues = async (\n\tstoreName: Store,\n\tkeys: number[],\n) => {\n\tconst preload = Array.from({ length: Math.min(keys.length, preloadLimit) }, (_, index) => {\n\t\tconst id = keys[index]\n\t\tif (id) {\n\t\t\treturn preloadLibraryValue(storeName, id)\n\t\t}\n\n\t\treturn null\n\t})\n\tawait Promise.all(preload)\n}\n\nconst keysListDatabaseChangeHandler = (\n\tstoreName: Store,\n\tchanges: DatabaseChangeDetailsList,\n\t{ mutate, refetch }: DbChangeActions,\n): void => {\n\tlet needRefetch = false\n\tfor (const change of changes) {\n\t\tif (change.storeName !== storeName) {\n\t\t\tcontinue\n\t\t}\n\n\t\tif (\n\t\t\t// We have no way of knowing where should the new item be inserted.\n\t\t\t// So we just refetch the whole list.\n\t\t\tchange.operation === 'add' ||\n\t\t\t// If playlist name changes, order might change as well.\n\t\t\t(storeName === 'playlists' && change.operation === 'update')\n\t\t) {\n\t\t\tneedRefetch = true\n\t\t\tbreak\n\t\t}\n\n\t\tif (change.operation === 'delete' && change.key !== undefined) {\n\t\t\tmutate((value) => {\n\t\t\t\tif (!value) {\n\t\t\t\t\treturn []\n\t\t\t\t}\n\n\t\t\t\tconst index = value.indexOf(change.key)\n\t\t\t\tif (index === -1) {\n\t\t\t\t\treturn value\n\t\t\t\t}\n\n\t\t\t\tvalue.splice(index, 1)\n\n\t\t\t\treturn value\n\t\t\t})\n\t\t}\n\t}\n\n\tif (needRefetch) {\n\t\trefetch()\n\t}\n}\n\nexport type LibraryItemKeysPageQueryOptions = Omit<\n\tPageQueryOptions,\n\t'onDatabaseChange'\n>\n\nexport const createLibraryItemKeysPageQuery = <\n\tStore extends LibraryStoreName,\n\tconst K extends QueryKey,\n>(\n\tstoreName: Store,\n\toptions: LibraryItemKeysPageQueryOptions,\n): Promise> =>\n\tcreatePageQuery({\n\t\t...options,\n\t\tfetcher: async (key, signal) => {\n\t\t\tconst result = await options.fetcher(key, signal)\n\t\t\tawait preloadLibraryListValues(storeName, result)\n\n\t\t\treturn result\n\t\t},\n\t\tonDatabaseChange: keysListDatabaseChangeHandler.bind(null, storeName),\n\t})\n"
},
{
"path": "src/lib/library/get/ids.ts",
"content": "import type { IDBPIndex } from 'idb'\nimport { type AppDB, type AppIndexNames, getDatabase } from '$lib/db/database.ts'\nimport type { LibraryStoreName } from '../types.ts'\n\nexport type SortOrder = 'asc' | 'desc'\nexport type LibraryItemSortKey = Exclude<\n\tAppIndexNames,\n\tsymbol\n>\n\nexport interface GetLibraryItemIdsOptions {\n\tsort: LibraryItemSortKey\n\torder?: SortOrder\n\tsearchTerm?: string\n\tsearchFn?: (value: AppDB[Store]['value'], term: string) => boolean\n\tsignal?: AbortSignal\n}\n\ntype GetLibraryItemIdsIndex = IDBPIndex<\n\tAppDB,\n\t[Store],\n\tStore,\n\tkeyof AppDB[Store]['indexes'] & string\n>\n\nconst getLibraryItemIdsWithSearchSlow = async (\n\tstoreIndex: GetLibraryItemIdsIndex,\n\tsearchTerm: string,\n\tsearchFn: (value: AppDB[Store]['value'], term: string) => boolean,\n\tsignal: AbortSignal | undefined,\n) => {\n\tconst data: number[] = []\n\n\tfor await (const cursor of storeIndex.iterate()) {\n\t\tif (signal?.aborted) {\n\t\t\tbreak\n\t\t}\n\n\t\tif (searchFn(cursor.value, searchTerm)) {\n\t\t\tdata.push(cursor.primaryKey)\n\t\t}\n\t}\n\n\treturn data\n}\n\nexport const getLibraryItemIds = async (\n\tstore: Store,\n\toptions: GetLibraryItemIdsOptions,\n): Promise => {\n\tconst db = await getDatabase()\n\tconst storeIndex = db.transaction(store).store.index(options.sort)\n\n\tconst { searchTerm, searchFn } = options\n\n\tlet data: number[]\n\tif (searchTerm && searchFn) {\n\t\tdata = await getLibraryItemIdsWithSearchSlow(\n\t\t\tstoreIndex,\n\t\t\tsearchTerm,\n\t\t\tsearchFn,\n\t\t\toptions.signal,\n\t\t)\n\t} else {\n\t\t// Fast path\n\t\tdata = await db.getAllKeysFromIndex(store, options.sort)\n\t}\n\n\tif (options.order === 'desc') {\n\t\tdata.reverse()\n\t}\n\n\treturn data\n}\n\nexport const dbGetAlbumTracksIdsByName = async (albumName: string): Promise => {\n\tconst db = await getDatabase()\n\tconst tracksIds = await db.getAllKeysFromIndex(\n\t\t'tracks',\n\t\t'byAlbumSorted',\n\t\tIDBKeyRange.bound([albumName], [albumName, '\\uffff']),\n\t)\n\n\treturn tracksIds\n}\n\nexport const dbGetArtistTracksIdsByName = async (artistName: string): Promise => {\n\tconst db = await getDatabase()\n\tconst tracksIds = await db.getAllKeysFromIndex(\n\t\t'tracks',\n\t\t'artists',\n\t\tIDBKeyRange.only(artistName),\n\t)\n\n\treturn tracksIds\n}\n"
},
{
"path": "src/lib/library/get/value-queries.ts",
"content": "import { createQuery, type QueryResult } from '$lib/db/query/query.ts'\nimport type { LibraryStoreName } from '../types.ts'\nimport { type GetLibraryValueResult, getLibraryValue, shouldRefetchLibraryValue } from './value.ts'\n\nexport type { AlbumData, ArtistData, PlaylistData, TrackData } from './value.ts'\n\nexport interface LibraryValueQueryOptions {\n\tallowEmpty?: AllowEmpty\n}\n\nconst defineQuery =\n\t(storeName: Store) =>\n\t(\n\t\tidGetter: () => number,\n\t\toptions: LibraryValueQueryOptions = {},\n\t): QueryResult> =>\n\t\tcreateQuery({\n\t\t\tkey: idGetter,\n\t\t\tfetcher: (id) => getLibraryValue(storeName, id, options.allowEmpty),\n\t\t\tonDatabaseChange: (changes, { refetch }) => {\n\t\t\t\tif (shouldRefetchLibraryValue(storeName, idGetter(), changes)) {\n\t\t\t\t\tvoid refetch()\n\t\t\t\t}\n\t\t\t},\n\t\t})\n\ntype LibraryItemQuery = ReturnType>\n\nexport const createTrackQuery: LibraryItemQuery<'tracks'> = /* @__PURE__ */ defineQuery('tracks')\nexport const createAlbumQuery: LibraryItemQuery<'albums'> = /* @__PURE__ */ defineQuery('albums')\nexport const createArtistQuery: LibraryItemQuery<'artists'> = /* @__PURE__ */ defineQuery('artists')\nexport const createPlaylistQuery: LibraryItemQuery<'playlists'> =\n\t/* @__PURE__ */ defineQuery('playlists')\n"
},
{
"path": "src/lib/library/get/value.ts",
"content": "import { WeakLRUCache } from 'weak-lru-cache'\nimport { type DbKey, getDatabase } from '$lib/db/database.ts'\nimport { type DatabaseChangeDetails, onDatabaseChange } from '$lib/db/events.ts'\nimport type { Album, Artist, Playlist, Track } from '$lib/library/types.ts'\nimport { FAVORITE_PLAYLIST_ID, FAVORITE_PLAYLIST_UUID, type LibraryStoreName } from '../types.ts'\n\ntype CacheKey = `${Store}:${string}`\n\nconst getCacheKey = (\n\tstoreName: Store,\n\tkey: DbKey,\n): CacheKey => `${storeName}:${key}`\n\ninterface QueryConfig {\n\tfetch: (id: number) => Promise\n\tshouldRefetch: (\n\t\titemId: number | undefined,\n\t\tchanges: readonly DatabaseChangeDetails[],\n\t) => boolean\n}\n\nconst defaultRefreshOnDatabaseChanges = (\n\tstoreName: LibraryStoreName,\n\titemId: number | undefined,\n\tchanges: readonly DatabaseChangeDetails[],\n) => {\n\tfor (const change of changes) {\n\t\tif (change.storeName === storeName) {\n\t\t\tif (itemId === undefined) {\n\t\t\t\treturn true\n\t\t\t}\n\n\t\t\tif (change.key === itemId) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t}\n\t}\n\n\treturn false\n}\n\nexport interface TrackData extends Track {\n\ttype: 'track'\n\tfavorite: boolean\n}\n\nconst trackConfig: QueryConfig = {\n\tfetch: async (id) => {\n\t\tconst db = await getDatabase()\n\t\tconst tx = db.transaction(['tracks', 'playlistEntries'], 'readonly')\n\n\t\tconst [item, favorite] = await Promise.all([\n\t\t\ttx.objectStore('tracks').get(id),\n\t\t\ttx\n\t\t\t\t.objectStore('playlistEntries')\n\t\t\t\t.index('playlistTrack')\n\t\t\t\t.get([FAVORITE_PLAYLIST_ID, id]),\n\t\t])\n\n\t\tif (!item) {\n\t\t\treturn undefined\n\t\t}\n\n\t\treturn {\n\t\t\t...item,\n\t\t\ttype: 'track',\n\t\t\tfavorite: !!favorite,\n\t\t} as TrackData\n\t},\n\tshouldRefetch: (itemId, changes) => {\n\t\tfor (const change of changes) {\n\t\t\tif (change.storeName === 'playlistEntries') {\n\t\t\t\tconst playlistEntry = change.value\n\n\t\t\t\tif (\n\t\t\t\t\tplaylistEntry.playlistId === FAVORITE_PLAYLIST_ID &&\n\t\t\t\t\titemId === playlistEntry.trackId\n\t\t\t\t) {\n\t\t\t\t\treturn true\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (change.storeName === 'tracks' && change.key === itemId) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t}\n\n\t\treturn false\n\t},\n}\n\nconst dbGetValue = async (\n\tstoreName: Store,\n\ttype: T,\n\tid: number,\n) => {\n\tconst db = await getDatabase()\n\tconst value = await db.get(storeName, id)\n\tif (!value) {\n\t\treturn undefined\n\t}\n\n\treturn {\n\t\t...value,\n\t\ttype,\n\t}\n}\n\nexport interface AlbumData extends Album {\n\ttype: 'album'\n}\n\nconst albumConfig: QueryConfig = {\n\tfetch: (id) => dbGetValue('albums', 'album', id),\n\tshouldRefetch: defaultRefreshOnDatabaseChanges.bind(null, 'albums'),\n}\nexport interface ArtistData extends Artist {\n\ttype: 'artist'\n}\n\nconst artistConfig: QueryConfig
![\"Snae](\"https://raw.githubusercontent.com/minht11/local-music-pwa/main/src/routes/(marketing)/assets/hero.avif\")
\n