import { useStorage } from '@vueuse/core' import type { convert_args_response,Paginated } from '~/types/responses' import type { StoreItem } from '~/types/store' const AG_SEPARATOR = '.' const separators = [ { name: 'Comma', value: ',', }, { name: 'Semicolon', value: ';', }, { name: 'Colon', value: ':', }, { name: 'Pipe', value: '|', }, { name: 'Space', value: ' ', } ] /** * Get value from object or function. * * @param obj - A function or value. * @returns The result of calling the function if it's a function, otherwise the value. */ const getValue = (obj: (() => T) | T): T => { return 'function' === typeof obj ? (obj as () => T)() : obj } /** * Safely get a value from a nested object using a path string. Returns default value if not found. * * @param obj - The object to get the value from. * @param path - Dot-delimited string path (e.g. 'a.b.c'). * @param defaultValue - The fallback value if path is not found or value is null/undefined. * @returns The value at the path or the default value. */ const ag = (obj: any, path: string, defaultValue: T | null = null): T | null => { const keys = path.split(AG_SEPARATOR) let at = obj for (const key of keys) { if ('object' === typeof at && null !== at && key in at) { at = at[key] } else { return getValue(defaultValue) } } return getValue(null === at ? defaultValue : at) } /** * Set a value in a nested object using a dot-delimited path. * * @param obj - The object to modify. * @param path - Dot-delimited string path (e.g. 'a.b.c'). * @param value - The value to set. * @returns The original object with the updated value. * @throws Error if a path segment is not an object. */ const ag_set = (obj: Record, path: string, value: any): Record => { const keys = path.split(AG_SEPARATOR) let at: any = obj while (keys.length > 0) { if (1 === keys.length) { if ('object' === typeof at && null !== at) { at[keys.shift()!] = value } else { throw new Error(`Cannot set value at this path (${path}) because it's not an object.`) } } else { const key = keys.shift()! if (!at[key] || 'object' !== typeof at[key]) { at[key] = {} } at = at[key] } } return obj } /** * Wait for an element to appear in the DOM, then invoke a callback. * * @param sel - CSS selector for the target element. * @param callback - Function to execute when the element is found. */ const awaitElement = (sel: string, callback: (el: Element, selector: string) => void): void => { const $elm = document.querySelector(sel) if ($elm) { callback($elm, sel) return } const interval = setInterval(() => { const $elm = document.querySelector(sel) if ($elm) { clearInterval(interval) callback($elm, sel) } }, 200) } /** * Replace template tags in a string with values from a context object. * * @param text - The input string containing tags in `{key}` format. * @param context - An object whose keys are used for tag replacement. * @returns The string with all matching tags replaced. */ const r = (text: string, context: Record = {}): string => { const tagLeft = '{' const tagRight = '}' if (!text.includes(tagLeft) || !text.includes(tagRight)) { return text } const pattern = new RegExp(`${tagLeft}([\\w_.]+)${tagRight}`, 'g') const matches = text.match(pattern) if (!matches) return text const replacements: Record = {} matches.forEach(match => { const key = match.slice(1, -1) replacements[match] = String(ag(context, key, '')) }) for (const key in replacements) { text = text.replace(new RegExp(key, 'g'), String(replacements[key])) } return text } /** * Dispatch a custom event on the global window object. * * @param eventName - The name of the custom event. * @param detail - Optional detail payload to include in the event. * @returns Whether the event was successfully dispatched. */ const dEvent = (eventName: string, detail: Record = {}): boolean => { return window.dispatchEvent(new CustomEvent(eventName, { detail })) } /** * Generate a pagination list based on current page, total pages, and delta range. * * @param current - The current active page number. * @param last - The last page number. * @param delta - How many pages to show before/after the current page. * @returns An array of pagination entries including optional gaps. */ const makePagination = (current: number, last: number, delta: number = 5): Array<{ page: number; text: string; selected: boolean }> => { const pagination: Array<{ page: number; text: string; selected: boolean }> = [] if (last < 2) { return pagination } const strR = '-'.repeat(9 + `${last}`.length) const left = current - delta const right = current + delta + 1 for (let i = 1; i <= last; i++) { if (1 === i || last === i || (i >= left && i < right)) { if (i === left && i > 2) { pagination.push({ page: 0, text: strR, selected: false }) } pagination.push({ page: i, text: `Page #${i}`, selected: i === current }) if (i === right - 1 && i < last - 1) { pagination.push({ page: 0, text: strR, selected: false }) } } } return pagination } /** * Safely encode a path string for use in a URL. * * @param item - The input path string. * @returns The URL-encoded path. */ const encodePath = (item: string): string => { if (!item) { return item } return item.split('/').map(segment => { try { const decoded = decodeURIComponent(segment) const reEncoded = encodeURIComponent(decoded) if (reEncoded === segment) { return segment } } catch { // Decoding failed, segment has invalid encoding } const placeholders: string[] = [] const _PREFIX = `_YTP${Math.random().toString(36).substring(2, 8).toUpperCase()}_` const _SUFFIX = `_YTP${Math.random().toString(36).substring(2, 8).toUpperCase()}_` let processed = segment.replace(/%[0-9A-Fa-f]{2}/g, match => { const index = placeholders.length placeholders.push(match) return `${_PREFIX}${index}${_SUFFIX}` }) processed = encodeURIComponent(processed) const placeholderRegex = new RegExp(`${_PREFIX.replace(/_/g, '_')}(\\d+)${_SUFFIX.replace(/_/g, '_')}`, 'g') processed = processed.replace(placeholderRegex, (_match, index: string) => { return placeholders[parseInt(index)] || '' }) return processed }).join('/') } /** * Request content from the API with automatic token handling and URL prefixing. * * @param url - The URL to request. If relative, it will be passed through the `uri` helper. * @param options - Optional fetch options, automatically extended with common headers and credentials. * @returns The fetch Response promise. */ const request = (url: string, options: RequestInit = {}): Promise => { options.method = options.method || 'GET' options.headers = options.headers || {}; (options as any).withCredentials = true if (undefined === (options.headers as Record)['Content-Type']) { if (!(options?.body instanceof FormData)) { ; (options.headers as Record)['Content-Type'] = 'application/json' } } if (undefined === (options.headers as Record)['Accept']) { ; (options.headers as Record)['Accept'] = 'application/json' } if (url.startsWith('/')) { options.credentials = 'same-origin' } return fetch(url.startsWith('/') ? uri(url) : url, options) } /** * Remove ANSI color codes from a string. * * @param text - The text potentially containing ANSI codes. * @returns A string without ANSI escape sequences. */ const removeANSIColors = (text: string): string => { // eslint-disable-next-line no-control-regex return text?.replace(/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g, '') ?? text } /** * Convert a decimal value to a 2-character hex string. * * @param dec - Decimal value between 0-255. * @returns The hex string. */ const dec2hex = (dec: number): string => dec.toString(16).padStart(2, '0') /** * Generate a random ID using crypto. * * @param len - The length of the ID in characters (must be even). * @returns A random hex ID string. */ const makeId = (len: number = 40): string => Array.from(window.crypto.getRandomValues(new Uint8Array(len / 2)), dec2hex).join('') /** * Return the basename of a given path. * * @param path - The input path. * @param ext - Optional extension to strip from the basename. * @returns The last segment of the path, minus the extension if matched. */ const basename = (path: string, ext: string = ''): string => { if (!path) return '' const segments = path.replace(/\\/g, '/').split('/') let base = segments.pop() || '' while (segments.length && base === '') { base = segments.pop() || '' } if (ext && base.endsWith(ext) && base !== ext) { base = base.substring(0, base.length - ext.length) } return base } /** * Return the directory portion of a path. * * @param filePath - The input file path. * @returns The directory part of the path. */ const dirname = (filePath: string): string => { const lastIndex = Math.max(filePath.lastIndexOf('/'), filePath.lastIndexOf('\\')) if (-1 === lastIndex) { return '.' } if (0 === lastIndex) { return filePath[0] ?? '.' } return filePath.substring(0, lastIndex) } /** * Copy text to clipboard with optional notification and storage flag. * * @param str - The string to copy. * @param notify - Whether to show a toast notification (default: true). * @param store - Whether to persist the notification (optional). */ const copyText = (str: string, notify: boolean = true, store: boolean = false): void => { const toast = useNotification() if (navigator.clipboard) { navigator.clipboard.writeText(str).then(() => { if (notify) toast.success('Text copied to clipboard.') }).catch((error) => { console.error('Failed to copy.', error) if (notify) toast.error('Failed to copy to clipboard.') }) return } const el = document.createElement('textarea') el.value = str document.body.appendChild(el) el.select() document.execCommand('copy') document.body.removeChild(el) if (notify) { const toast = useNotification() toast.success('Text copied to clipboard.', { store }) } } /** * Trim delimiter characters from a string at specified positions. * * @param str - The input string to trim. * @param delim - The delimiter character to trim. * @param position - Where to trim the delimiter from: 'start', 'end', or 'both'. Defaults to 'both'. * @returns The trimmed string. * @throws Will throw an error if `delim` is not provided. */ const iTrim = (str: string, delim: string, position: 'start' | 'end' | 'both' = 'both'): string => { if (!str) { return str } if (!delim) { throw new Error('Delimiter is required') } // Escape special regex characters for use in character class // Characters that need escaping in character classes: \ ] ^ - const escapedDelim = delim.replace(/[\\^\-\]]/g, '\\$&') if (['both', 'start'].includes(position)) { str = str.replace(new RegExp(`^[${escapedDelim}]+`, 'g'), '') } if (['both', 'end'].includes(position)) { str = str.replace(new RegExp(`[${escapedDelim}]+$`, 'g'), '') } return str } /** * Trim delimiter characters from the end of a string. * * @param str - The input string to trim. * @param delim - The delimiter character to trim. * @returns The trimmed string. */ const eTrim = (str: string, delim: string): string => iTrim(str, delim, 'end') /** * Trim delimiter characters from the start of a string. * * @param str - The input string to trim. * @param delim - The delimiter character to trim. * @returns The trimmed string. */ const sTrim = (str: string, delim: string): string => iTrim(str, delim, 'start') /** * Uppercase the first character of the string. * * @param str - The input string. * @returns The string with the first character capitalized. */ const ucFirst = (str: string): string => (!str) ? str : str.charAt(0).toUpperCase() + str.slice(1) /** * Get the name of a separator based on its value * * @param {string} value - The separator value * * @returns {string} The name of the separator, or 'Unknown' if not found */ const getSeparatorsName = (value: string): string => { const sep = separators.find(s => s.value === value) return sep ? `${sep.name} (${value})` : 'Unknown' } /** * Convert options to JSON * * @param {string} opts * * @returns {Promise} The converted options */ const convertCliOptions = async (opts: string): Promise => { const response = await request('/api/yt-dlp/convert', { method: 'POST', body: JSON.stringify({ args: opts }), }); const data = await response.json() if (200 !== response.status) { throw new Error(`Error: (${response.status}): ${data.error}`) } return data } /** * Get query parameters from a URL string or the current location. * * @param url - The full URL or search string (default: current URL's search). * @returns A key-value map of query parameters. */ const getQueryParams = (url: string = window.location.search): Record => { return Object.fromEntries(new URLSearchParams(url).entries()) } /** * Build a download URL based on config and item metadata. * * @param config - The application config object. * @param item - The item containing filename/folder. * @param base - The base endpoint type (default: 'api/download'). * @param playlist - Whether to generate a playlist URL (default: false). * @returns The fully constructed download URI. */ const makeDownload = (config: any, item: StoreItem | { folder?: string; filename: string }, base: string = 'api/download', playlist: boolean = false): string => { let baseDir = 'api/player/m3u8/video/' if ('m3u8' !== base) { baseDir = `${base}/` } if (item.folder) { item.folder = item.folder.replace(/#/g, '%23') baseDir += item.folder + '/' } if (!item.filename) { return '' } const url = `/${sTrim(baseDir, '/')}${encodePath(item.filename)}` return uri('m3u8' === base || true === playlist ? `${url}.m3u8` : url) } /** * Format bytes to a human-readable string. * * @param bytes - The number of bytes. * @param decimals - Number of decimal places to include. * @returns A formatted size string (e.g., '2.00 MiB'). */ const formatBytes = (bytes: number, decimals: number = 2): string => { if (!+bytes) { return '0 Bytes' } const k = 1024 const dm = decimals < 0 ? 0 : decimals const sizes = ['Bytes', 'KiB', 'MiB', 'GiB', 'TiB', 'PiB', 'EiB', 'ZiB', 'YiB'] const i = Math.floor(Math.log(bytes) / Math.log(k)) return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}` } /** * Check if input has non-empty data. * * @param item - The input (object, array, or JSON string). * @returns True if it contains data, false otherwise. */ const has_data = (item: any): boolean => { if (!item) { return false } if ('string' === typeof item) { try { item = JSON.parse(item) } catch { return true } } try { if ('object' === typeof item) return Object.keys(item).length > 0 return item.length > 0 } catch (e) { console.error(e) return false } } /** * Toggle a class on a DOM element. Supports array of class names. * * @param target - The HTML element to toggle classes on. * @param className - Class name or array of class names. */ const toggleClass = (target: HTMLElement, className: string | string[]): void => { if (Array.isArray(className)) { className.forEach(cls => toggleClass(target, cls)) return } if (target.classList.contains(className)) { target.classList.remove(className) } else { target.classList.add(className) } } /** * Remove specified fields from an object. * * @param item - Input object. * @param fields - Keys to exclude. * @returns A new object without the excluded keys. */ const cleanObject = >(item: T, fields: string[] = []): Partial => { if (!item || typeof item !== 'object' || fields.length < 1) return item const cleaned: Partial = {} for (const key of Object.keys(item)) { if (!fields.includes(key)) { cleaned[key as keyof T] = item[key] } } return cleaned } /** * Prefix URL with baseURL if needed. * * @param u - The input path. * @returns The fully prefixed URI. */ const uri = (u: string): string => { const runtimeConfig = useRuntimeConfig() if (!u || '/' === runtimeConfig.app.baseURL || !u.startsWith('/')) { return u } if (u.startsWith(runtimeConfig.app.baseURL)) { return u } return `${eTrim(runtimeConfig.app.baseURL, '/')}/${sTrim(u, '/')}` } /** * Format seconds into HH:MM:SS or MM:SS. * * @param seconds - Time in seconds. * @returns A time string. */ const formatTime = (seconds: number): string => { const hrs = Math.floor(seconds / 3600) const mins = Math.floor((seconds % 3600) / 60) const secs = Math.floor(seconds % 60) const pad = (n: number): string => n.toString().padStart(2, '0') if (hrs > 0) { return `${pad(hrs)}:${pad(mins)}:${pad(secs)}` } if (mins > 0) { return `${pad(mins)}:${pad(secs)}` } return `${secs}` } /** * Pause execution for a number of seconds. * * @param seconds - Number of seconds to sleep. * @returns A promise that resolves after the delay. */ const sleep = (seconds: number): Promise => new Promise(resolve => setTimeout(resolve, seconds * 1000)) /** * Waits for the test function to return a truthy value. * * @param test - The function to test * @param timeout_ms - The maximum time to wait in milliseconds. * @param frequency - The frequency to check the test function in milliseconds. * * @returns The result of the test function. */ // eslint-disable-next-line @typescript-eslint/no-unsafe-function-type const awaiter = async (test: Function, timeout_ms: number = 20 * 1000, frequency: number = 200) => { if (typeof (test) != "function") { throw new Error("test should be a function in awaiter(test, [timeout_ms], [frequency])") } const isNotTruthy = (val: any) => val === undefined || val === false || val === null || val.length === 0; const endTime: number = Date.now() + timeout_ms; let result = test(); while (isNotTruthy(result)) { if (Date.now() > endTime) { return false; } await sleep(frequency); result = test(); } return result; } /** * Encode a JavaScript object into a URL-safe base64 string. * * @param obj - The object to encode. * @returns A URL-safe base64-encoded string. */ const encode = (obj: Record): string => { const jsonStr = JSON.stringify(obj); const utf8Bytes = new TextEncoder().encode(jsonStr); const binary = String.fromCharCode(...utf8Bytes); const base64 = btoa(binary); return base64.replace(/\+/g, '-').replace(/\//g, '_').replace(/=+$/, ''); } /** * Decode a URL-safe base64 string into an object. * * @param str - The URL-safe base64-encoded string. * @returns The decoded JavaScript object. */ const decode = (str: string): object => { const base64 = str .replace(/-/g, '+') .replace(/_/g, '/') .padEnd(str.length + (4 - str.length % 4) % 4, '='); const binary = atob(base64); const bytes = Uint8Array.from(binary, c => c.charCodeAt(0)); const jsonStr = new TextDecoder().decode(bytes); return JSON.parse(jsonStr); } const disableOpacity = (): boolean => { const bg_enable = useStorage('random_bg', true) if (!bg_enable) { return false; } document.querySelector('body')?.setAttribute("style", `opacity: 1.0`) return true } const enableOpacity = (): boolean => { const bg_enable = useStorage('random_bg', true) if (!bg_enable) { return false; } const bg_opacity = useStorage('random_bg_opacity', 0.95) document.querySelector('body')?.setAttribute("style", `opacity: ${bg_opacity.value}`) return true } const stripPath = (base_path: string, real_path: string): string => { if (!base_path) { return real_path } return real_path.replace(base_path, '').replace(/^\//, '') } const shortPath = (path: string, prefix: string = '...'): string => { if (typeof path !== 'string') { return path; } const hasTrailingSlash = /\/$/.test(path); const clean = path.replace(/\/+$/, ''); const parts = clean.split('/').filter(Boolean); if (parts.length <= 1) { return path; } return `${prefix}/${parts.at(-1)}${hasTrailingSlash ? '/' : ''}`; } /** * Recursively test if a value (including nested objects/arrays) contains a query string. * - Plain queries match keys or values (case-insensitive). * - key:value queries require the value to be under a matching key in the path. * * @param value - Value to search within. * @param query - Raw query string. * @param seen - Optional WeakSet to prevent circular reference loops. * @param kv - Internal: parsed key/value pair when using key:value mode. * @param keyMatched - Internal: whether current recursion path matched the key. */ const deepIncludes = ( value: unknown, query: string, seen: WeakSet = new WeakSet(), kv: { key: string; val: string } | null = null, keyMatched: boolean = false ): boolean => { const normalized = query.trim().toLowerCase() if (!normalized || null === value || undefined === value) { return false } const pair = kv ?? (() => { const idx = normalized.indexOf(':') if (idx <= 0 || idx >= normalized.length - 1) { return null } const key = normalized.slice(0, idx).trim() const val = normalized.slice(idx + 1).trim() if (!key || !val) { return null } return { key, val } })() const matchPrimitive = (val: unknown, q: string): boolean => String(val).toLowerCase().includes(q) if (typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean') { if (!pair) { return matchPrimitive(value, normalized) } return keyMatched && matchPrimitive(value, pair.val) } if (Array.isArray(value)) { return value.some(entry => deepIncludes(entry, normalized, seen, pair, keyMatched)) } if ('object' === typeof value) { const obj = value as Record if (seen.has(obj)) { return false } seen.add(obj) for (const [key, val] of Object.entries(obj)) { const keyLower = key.toLowerCase() if (!pair && keyLower.includes(normalized)) { return true } const nextKeyMatched = pair ? keyMatched || keyLower.includes(pair.key) : keyMatched if (deepIncludes(val, normalized, seen, pair, nextKeyMatched)) { return true } } } return false } const getPath = (basePath: string, item: StoreItem): string => { if (!item.folder && ((!item.filename && item.download_dir === basePath) || !item.download_dir)) { return shortPath(basePath) } if (!item?.filename) { return stripPath(eTrim(basePath, '/'), '/' + sTrim(eTrim(item.download_dir || item.folder, '/'), '/')) } return stripPath(eTrim(basePath, '/'), '/' + eTrim(item.download_dir, '/') + '/' + sTrim(item.filename, '/')) } const getImage = (basePath: string, item: StoreItem, fallback: boolean = true): string => { if (item.sidecar?.image && item.sidecar.image.length > 0) { return uri('/api/download/' + encodeURIComponent(stripPath(basePath, item.sidecar.image[0]?.file || ''))) } if (item?.extras?.thumbnail) { return uri('/api/thumbnail?id=' + item._id + '&url=' + encodePath(item.extras.thumbnail)) } return fallback ? uri('/images/placeholder.png') : '' } const parse_list_response = async (json: unknown): Promise> => { if ('function' === typeof (json as any).then) { json = await (json as Promise) } if (!json || 'object' !== typeof json) { return { items: [], pagination: { page: 1, per_page: 20, total: 0, total_pages: 0, has_next: false, has_prev: false } } } const payload = json as Paginated const items = Array.isArray(payload.items) ? payload.items : [] const pagination = { page: Number(payload.pagination?.page ?? 1), per_page: Number(payload.pagination?.per_page ?? 20), total: Number(payload.pagination?.total ?? 0), total_pages: Number(payload.pagination?.total_pages ?? 0), has_next: Boolean(payload.pagination?.has_next ?? false), has_prev: Boolean(payload.pagination?.has_prev ?? false), } return { items: items as T[], pagination } } const parse_api_response = async (json: unknown): Promise => { if ('function' === typeof (json as any).then) { json = await (json as Promise) } return json as T } const parse_api_error = async (json: unknown): Promise => { if ('function' === typeof (json as any).then) { json = await (json as Promise) } if (!json || 'object' !== typeof json) { return 'Unknown error occurred' } const payload = json as { error?: string; message?: string; detail?: string[]; } return String(payload.error ?? payload.message ?? payload.detail?.[0] ?? 'Unknown error occurred') } export { separators, convertCliOptions, getSeparatorsName, iTrim, eTrim, sTrim, ucFirst, getValue, ag, ag_set, awaitElement, r, copyText, dEvent, makePagination, encodePath, request, removeANSIColors, dec2hex, makeId, basename, dirname, getQueryParams, makeDownload, formatBytes, has_data, toggleClass, cleanObject, uri, formatTime, sleep, awaiter, encode, decode, disableOpacity, enableOpacity, stripPath, shortPath, deepIncludes, getPath, getImage, parse_list_response, parse_api_response, parse_api_error }