prismcast 1.4.2 → 1.5.0

package/dist/types/profiles.d.ts

@@ -0,0 +1,141 @@
+import type { ChannelMap } from "./channels.js";
+import type { Nullable } from "./shared.js";
+/**
+ * Available channel selection strategies. Each strategy implements a different approach to finding and selecting channels in a multi-channel player UI.
+ *
+ * - "directvGrid": Tune via webpack injection — captures __webpack_require__, extracts the Redux store from the React fiber tree, matches by channel name, and
+ *   dispatches playConsumable. Falls back to logo aria-label click when the interceptor fails. Used by DirecTV Stream.
+ * - "foxGrid": Find channel by station code in a non-virtualized guide grid, click the channel logo button via DOM .click(). Used by Fox.com.
+ * - "guideGrid": Find channel by exact-matching image alt text, click nearest clickable ancestor. Optionally clicks a tab to reveal the list first. Used by Hulu
+ *   Live TV.
+ * - "hboGrid": Discover the HBO tab page URL from the homepage menu bar, scrape the live channel tile rail for a matching channel name, and navigate to the watch
+ *   URL. Caches the tab URL across tunes with stale-cache fallback. Used by HBO Max.
+ * - "none": No channel selection needed (single-channel sites). This is the default.
+ * - "slingGrid": Find channel by data-testid in a virtualized A-Z guide grid, scroll via binary search on .guide-cell scrollTop, click the on-now program
+ *   cell. Used by Sling TV.
+ * - "thumbnailRow": Find channel element using the profile's matchSelector (defaults to image URL matching), click adjacent element on the same row. Used by
+ *   USA Network.
+ * - "tileClick": Find channel element using the profile's matchSelector (defaults to image URL matching), click tile, then optionally click play button if
+ *   playSelector is configured. Used by Disney+.
+ * - "youtubeGrid": Find channel by aria-label in a non-virtualized EPG grid, extract the watch URL, and navigate directly. Used by YouTube TV.
+ */
+export type ChannelSelectionStrategy = "directvGrid" | "foxGrid" | "guideGrid" | "hboGrid" | "none" | "slingGrid" | "thumbnailRow" | "tileClick" | "youtubeGrid";
+/**
+ * Configuration for channel selection behavior within a site profile.
+ */
+export interface ChannelSelectionConfig {
+    listSelector?: string;
+    matchSelector?: string;
+    playSelector?: string;
+    scrollSelector?: string;
+    scrollTarget?: string;
+    scrollToBottom?: boolean;
+    strategy: ChannelSelectionStrategy;
+}
+/**
+ * UI category for profile grouping in dropdowns and reference documentation. Profiles are grouped by their fullscreen mechanism and special characteristics.
+ * - "api": Profiles using the JavaScript fullscreen API (including embedded iframe and click-to-play variants).
+ * - "custom": User-defined profiles created via the profile builder wizard or imported from provider packs.
+ * - "keyboard": Profiles using keyboard shortcuts (typically the 'f' key) for fullscreen.
+ * - "multiChannel": Multi-channel profiles requiring a channel selector for tile or thumbnail-based channel selection.
+ * - "special": Special-purpose profiles like static page capture.
+ */
+export type ProfileCategory = "api" | "custom" | "keyboard" | "multiChannel" | "special";
+/**
+ * Site profile definition with optional flags. All flags are optional because profiles can inherit from other profiles, and only the flags that differ from the
+ * parent need to be specified. The DEFAULT_SITE_PROFILE provides baseline values for any flags not set through inheritance.
+ */
+export interface SiteProfile {
+    category?: ProfileCategory;
+    channelSelection?: ChannelSelectionConfig;
+    channelSelector?: Nullable<string>;
+    clickSelector?: Nullable<string>;
+    clickToPlay?: boolean;
+    description?: string;
+    extends?: string;
+    summary?: string;
+    fullscreenKey?: Nullable<string>;
+    fullscreenSelector?: Nullable<string>;
+    hideSelector?: Nullable<string>;
+    lockVolumeProperties?: boolean;
+    needsIframeHandling?: boolean;
+    noVideo?: boolean;
+    selectReadyVideo?: boolean;
+    useRequestFullscreen?: boolean;
+    waitForNetworkIdle?: boolean;
+}
+/**
+ * Fully-resolved site profile with all flags having concrete values. After resolving inheritance chains and applying defaults, every flag has a definite boolean
+ * or string value. This interface is used by stream handling code that needs to check profile flags without worrying about undefined values.
+ */
+export interface ResolvedSiteProfile {
+    channelSelection: ChannelSelectionConfig;
+    channelSelector: Nullable<string>;
+    clickSelector: Nullable<string>;
+    clickToPlay: boolean;
+    fullscreenKey: Nullable<string>;
+    fullscreenSelector: Nullable<string>;
+    hideSelector: Nullable<string>;
+    lockVolumeProperties: boolean;
+    maxContinuousPlayback: Nullable<number>;
+    needsIframeHandling: boolean;
+    noVideo: boolean;
+    selectReadyVideo: boolean;
+    useRequestFullscreen: boolean;
+    waitForNetworkIdle: boolean;
+}
+/**
+ * Result of resolving a site profile. Includes both the resolved profile configuration and the name of the profile that was matched. The name indicates whether the
+ * profile came from a channel hint, domain-based autodetection, or the default fallback.
+ */
+export interface ProfileResolutionResult {
+    profile: ResolvedSiteProfile;
+    profileName: string;
+}
+/**
+ * Domain-level configuration associating domain patterns with site profiles and provider display names. Each entry can specify a site profile for behavior
+ * configuration and/or a provider display name for friendly UI labels. Used by both built-in domain mappings in sites.ts and user-defined mappings in profiles.json.
+ */
+export interface DomainConfig {
+    loginUrl?: string;
+    maxContinuousPlayback?: number;
+    profile?: string;
+    provider?: string;
+    providerTag?: string;
+}
+/**
+ * Storage format for profiles.json. Contains user-defined site profiles and domain mappings that extend or override the built-in configurations.
+ */
+export interface UserProfilesFile {
+    domains?: Record<string, DomainConfig>;
+    profiles?: Record<string, SiteProfile>;
+}
+/**
+ * Result of loading user profiles from the profiles.json file.
+ */
+export interface UserProfilesLoadResult {
+    domains: Record<string, DomainConfig>;
+    parseError: boolean;
+    parseErrorMessage?: string;
+    profiles: Record<string, SiteProfile>;
+}
+/**
+ * Provider pack distribution format. Bundles a profile, domain mapping(s), and optionally channels for a streaming provider into a single JSON file. On import,
+ * its contents are split and written to profiles.json and channels.json.
+ */
+export interface ProviderPack {
+    channels?: ChannelMap;
+    domains?: Record<string, DomainConfig>;
+    name: string;
+    profiles: Record<string, SiteProfile>;
+    version: number;
+}
+/**
+ * Validation result for profile and domain imports.
+ */
+export interface ProfilesValidationResult {
+    domains: Record<string, DomainConfig>;
+    errors: string[];
+    profiles: Record<string, SiteProfile>;
+    valid: boolean;
+}

package/dist/types/profiles.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=profiles.js.map

package/dist/types/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/types/profiles.ts"],"names":[],"mappings":""}

package/dist/types/selection.d.ts

@@ -0,0 +1,101 @@
+import type { ChannelSelectionStrategy, ResolvedSiteProfile } from "./profiles.js";
+import type { Frame, Page } from "puppeteer-core";
+import type { Nullable } from "./shared.js";
+export interface ChannelSelectionProfile extends ResolvedSiteProfile {
+    channelSelector: string;
+}
+export declare function isChannelSelectionProfile(profile: ResolvedSiteProfile): profile is ChannelSelectionProfile;
+/**
+ * Result of attempting to select a channel from a multi-channel player UI.
+ */
+export interface ChannelSelectorResult {
+    directTune?: boolean;
+    reason?: string;
+    success: boolean;
+}
+/**
+ * The strategy function signature. All strategies take the Puppeteer page and a narrowed profile with guaranteed non-null channelSelector.
+ */
+export type ChannelStrategyHandler = (page: Page, profile: ChannelSelectionProfile) => Promise<ChannelSelectorResult>;
+/**
+ * The complete contract for a channel selection strategy. Each provider file exports a single object implementing this interface. The coordinator accesses all
+ * provider behavior through these hooks — no strategy-specific imports or hardcoded strategy name checks outside the registry.
+ */
+export interface ChannelStrategyEntry {
+    /**
+     * Resets all module-level caches (row positions, discovered URLs, watch URLs). Called on browser restart when cached state may be stale.
+     */
+    clearCache?: () => void;
+    /**
+     * Selects the target channel in the provider's guide UI. Receives a Puppeteer page and a profile with a guaranteed non-null channelSelector. Must handle its
+     * own retry logic (e.g., overlay dismiss) and return a result indicating success or failure with a diagnostic reason.
+     */
+    execute: ChannelStrategyHandler;
+    /**
+     * Removes a cached watch URL after it failed to produce a working stream. Called by the coordinator when a cached direct navigation fails.
+     */
+    invalidateDirectUrl?: (channelSelector: string) => void;
+    /**
+     * Returns a watch URL for direct navigation, bypassing guide page loading. Implementations may perform async work such as fetching current asset IDs from
+     * provider APIs. The page parameter allows setting up response interception or accessing browser context when needed (e.g., cold cache setup).
+     */
+    resolveDirectUrl?: (channelSelector: string, page: Page) => Promise<Nullable<string>>;
+}
+/**
+ * Standardized output shape for a channel discovered from a provider's guide. Produced by each provider's discoverChannels implementation and returned as
+ * a JSON array from the GET /providers/:slug/channels endpoint. Mirrors the shape of channel definitions in channels/index.ts so discovery output can be
+ * used directly to populate new entries.
+ */
+export interface DiscoveredChannel {
+    affiliate?: string;
+    channelSelector: string;
+    name: string;
+    tier?: string;
+}
+/**
+ * Unified provider contract that bundles identity metadata, tuning strategy, and channel discovery into a single registry entry. Each provider tuning file
+ * exports one ProviderModule. The coordinator builds its strategy dispatch lookup from provider modules at evaluation time. Generic strategies (thumbnailRow,
+ * tileClick) remain bare ChannelStrategyEntry objects — they are not providers.
+ */
+export interface ProviderModule {
+    /**
+     * Discovers all available channels from the provider's guide. The route handler navigates to guideUrl before calling this function unless handlesOwnNavigation
+     * is set. Returns a standardized DiscoveredChannel array.
+     */
+    discoverChannels: (page: Page) => Promise<DiscoveredChannel[]>;
+    /**
+     * Returns cached discovered channels if the provider has already fully enumerated its lineup from a previous tune or discovery call, or null if no enumeration
+     * has occurred. When non-null, the route handler can skip browser page creation entirely and return the cached result immediately.
+     */
+    getCachedChannels: () => Nullable<DiscoveredChannel[]>;
+    guideUrl: string;
+    handlesOwnNavigation?: boolean;
+    label: string;
+    slug: string;
+    strategy: ChannelStrategyEntry;
+    strategyName: ChannelSelectionStrategy;
+    validatePrecache?: (channels: DiscoveredChannel[]) => boolean;
+    validateTune?: (channelSelector: string) => boolean;
+}
+/**
+ * Coordinates for a click target, used when clicking channel selector elements.
+ */
+export interface ClickTarget {
+    x: number;
+    y: number;
+}
+/**
+ * Result of tuning to a channel, containing the video context needed for monitoring.
+ */
+export interface TuneResult {
+    context: Frame | Page;
+    directTune?: boolean;
+}
+/**
+ * Browser chrome dimensions (toolbars, borders) calculated by comparing window.outerHeight/Width to window.innerHeight/Width. Used to set window size such that
+ * the viewport (content area) matches our target dimensions.
+ */
+export interface UiSize {
+    height: number;
+    width: number;
+}

package/dist/types/selection.js

@@ -0,0 +1,6 @@
+// Type guard that proves channelSelector is a non-empty string. Matches the original !channelSelector truthiness check, which rejects both null and empty string.
+// Used by the coordinator before dispatching to strategy functions.
+export function isChannelSelectionProfile(profile) {
+    return (profile.channelSelector !== null) && (profile.channelSelector.length > 0);
+}
+//# sourceMappingURL=selection.js.map

package/dist/types/selection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.js","sourceRoot":"","sources":["../../src/types/selection.ts"],"names":[],"mappings":"AAeA,kKAAkK;AAClK,oEAAoE;AACpE,MAAM,UAAU,yBAAyB,CAAC,OAA4B;IAEpE,OAAO,CAAC,OAAO,CAAC,eAAe,KAAK,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpF,CAAC"}

package/dist/types/shared.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A utility type that represents a value that can be null.
+ * @typeParam T - The type that can be nullable.
+ */
+export type Nullable<T> = T | null;
+export type ChannelSortField = "channelNumber" | "channelSelector" | "key" | "name" | "profile" | "provider" | "stationId";
+export type SortDirection = "asc" | "desc";

package/dist/types/shared.js

@@ -0,0 +1,6 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * shared.ts: Shared utility types used across all PrismCast type domains.
+ */
+export {};
+//# sourceMappingURL=shared.js.map

package/dist/types/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/types/shared.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/types/streaming.d.ts

@@ -0,0 +1,96 @@
+import type { Nullable } from "./shared.js";
+import type { Page } from "puppeteer-core";
+import type { RecoveryMetrics } from "../streaming/recovery.js";
+/**
+ * Information about an active streaming session. Created when a stream request is received and deleted when the stream ends.
+ */
+export interface StreamInfo {
+    channelName: Nullable<string>;
+    id: number;
+    page: Page;
+    startTime: Date;
+    stopMonitor: Nullable<() => RecoveryMetrics>;
+    url: string;
+}
+/**
+ * Snapshot of a video element's playback state. Collected by the playback health monitor to detect stalls, errors, and other problems.
+ */
+export interface VideoState {
+    currentTime: number;
+    ended: boolean;
+    error: boolean;
+    muted: boolean;
+    networkState: number;
+    paused: boolean;
+    readyState: number;
+    time: number;
+    volume: number;
+}
+/**
+ * Strategy for selecting a video element when multiple are present. "selectFirstVideo" takes the first video in DOM order; "selectReadyVideo" finds the video
+ * with readyState >= 3, which typically identifies the actively playing main content rather than preloaded ads.
+ */
+export type VideoSelectorType = "selectFirstVideo" | "selectReadyVideo";
+/**
+ * Result of URL validation indicating whether the URL is safe to navigate to.
+ */
+export interface UrlValidationResult {
+    reason?: string;
+    valid: boolean;
+}
+/**
+ * Alias for UrlValidationResult maintained for backward compatibility with existing code.
+ */
+export type UrlValidation = UrlValidationResult;
+/**
+ * Health check response structure returned by the /health endpoint.
+ */
+export interface HealthStatus {
+    browser: {
+        connected: boolean;
+        pageCount: number;
+    };
+    captureMode: string;
+    chrome: Nullable<string>;
+    clients: {
+        byType: {
+            count: number;
+            type: string;
+        }[];
+        total: number;
+    };
+    ffmpegAvailable: boolean;
+    memory: {
+        heapTotal: number;
+        heapUsed: number;
+        rss: number;
+        segmentBuffers: number;
+    };
+    message?: string;
+    status: "degraded" | "healthy" | "unhealthy";
+    streams: {
+        active: number;
+        limit: number;
+    };
+    timestamp: string;
+    uptime: number;
+    version: string;
+}
+/**
+ * Information about a single active stream as returned by the /streams endpoint.
+ */
+export interface StreamListItem {
+    channel: Nullable<string>;
+    duration: number;
+    id: number;
+    startTime: string;
+    url: string;
+}
+/**
+ * Response structure for the /streams endpoint.
+ */
+export interface StreamListResponse {
+    count: number;
+    limit: number;
+    streams: StreamListItem[];
+}

package/dist/types/streaming.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=streaming.js.map

package/dist/types/streaming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streaming.js","sourceRoot":"","sources":["../../src/types/streaming.ts"],"names":[],"mappings":""}

package/dist/utils/debugFilter.js

@@ -123,6 +123,7 @@ export const DEBUG_CATEGORIES = [
     { category: "browser", description: "Browser lifecycle: launch, close, stale page cleanup, restart." },
     { category: "browser:video", description: "Video context, fullscreen, volume locking, playback." },
     { category: "config", description: "Provider groups, version checking." },
+    { category: "precache", description: "Channel lineup precaching: deferred runs, provider filter skips." },
     { category: "recovery", description: "General recovery: browser re-minimize, monitor abort." },
     { category: "recovery:context", description: "Video context: frame detachment, re-search." },
     { category: "recovery:nav", description: "Page navigation recovery: new tab detection, URL validation." },
@@ -131,7 +132,6 @@ export const DEBUG_CATEGORIES = [
     { category: "retry", description: "Retry attempts, page-closed aborts." },
     { category: "streaming:ffmpeg", description: "FFmpeg stderr output, pipe errors." },
     { category: "streaming:hls", description: "HLS segment storage, page close errors." },
-    { category: "streaming:mpegts", description: "MPEG-TS remuxer errors, client connect/disconnect." },
     { category: "streaming:segmenter", description: "fMP4 parsing: keyframes, init segments, duration clamping." },
     { category: "streaming:setup", description: "Stream setup: redirect resolution, profile override, capture init." },
     { category: "streaming:showinfo", description: "Channels DVR show name lookups, device mapping." },
@@ -141,9 +141,11 @@ export const DEBUG_CATEGORIES = [
     { category: "timing:startup", description: "Stream startup: init segment, first playlist, capture ready." },
     { category: "timing:tab", description: "Tab replacement: old tab cleanup, new page creation." },
     { category: "timing:tune", description: "Tune waterfall: navigation, channel selection, video ready." },
+    { category: "tuning:directv", description: "DirecTV Stream: interceptor tuning, cache, logo click fallback." },
     { category: "tuning:hbo", description: "HBO Max: tab URL discovery, channel rail, navigation." },
     { category: "tuning:hulu", description: "Hulu Live guide grid: binary search, cache, click retries." },
     { category: "tuning:sling", description: "Sling TV guide grid: binary search, cache, click retries." },
+    { category: "tuning:tileClick", description: "Tile click strategy: scroll phase, matchSelector poll, play button retries, modal dismiss." },
     { category: "tuning:yttv", description: "YouTube TV EPG grid navigation." }
 ];
 /**

package/dist/utils/debugFilter.js.map

@@ -1 +1 @@
-{"version":3,"file":"debugFilter.js","sourceRoot":"","sources":["../../src/utils/debugFilter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"debugFilter.js","sourceRoot":"","sources":["../../src/utils/debugFilter.ts"],"names":[],"mappings":"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"}

package/dist/utils/format.d.ts

@@ -7,6 +7,13 @@
  * @returns Formatted duration string.
  */
 export declare function formatDuration(ms: number): string;
+/**
+ * Formats a Unix millisecond timestamp as a human-readable relative time string (e.g., "2 minutes ago", "3 hours ago", "5 days ago"). Used for health indicator
+ * tooltips where absolute timestamps would be harder to interpret at a glance.
+ * @param timestamp - Unix millisecond timestamp.
+ * @returns Relative time string.
+ */
+export declare function formatTimeAgo(timestamp: number): string;
 /**
  * Extracts a concise domain from a URL by keeping only the last two portions of the hostname (e.g., "watch.foodnetwork.com" becomes "foodnetwork.com",
  * "www.hulu.com" becomes "hulu.com"). Used as a standard domain key for DOMAIN_CONFIG lookups and as a display fallback when no provider name is configured.

package/dist/utils/format.js

@@ -23,6 +23,28 @@ export function formatDuration(ms) {
     }
     return [String(seconds), "s"].join("");
 }
+/**
+ * Formats a Unix millisecond timestamp as a human-readable relative time string (e.g., "2 minutes ago", "3 hours ago", "5 days ago"). Used for health indicator
+ * tooltips where absolute timestamps would be harder to interpret at a glance.
+ * @param timestamp - Unix millisecond timestamp.
+ * @returns Relative time string.
+ */
+export function formatTimeAgo(timestamp) {
+    const seconds = Math.floor((Date.now() - timestamp) / 1000);
+    if (seconds < 60) {
+        return "just now";
+    }
+    const minutes = Math.floor(seconds / 60);
+    if (minutes < 60) {
+        return String(minutes) + (minutes === 1 ? " minute ago" : " minutes ago");
+    }
+    const hours = Math.floor(minutes / 60);
+    if (hours < 24) {
+        return String(hours) + (hours === 1 ? " hour ago" : " hours ago");
+    }
+    const days = Math.floor(hours / 24);
+    return String(days) + (days === 1 ? " day ago" : " days ago");
+}
 /**
  * Extracts a concise domain from a URL by keeping only the last two portions of the hostname (e.g., "watch.foodnetwork.com" becomes "foodnetwork.com",
  * "www.hulu.com" becomes "hulu.com"). Used as a standard domain key for DOMAIN_CONFIG lookups and as a display fallback when no provider name is configured.

package/dist/utils/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IAEvC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAElC,IAAG,KAAK,GAAG,CAAC,EAAE,CAAC;QAEb,OAAO,CAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,IAAG,OAAO,GAAG,CAAC,EAAE,CAAC;QAEf,OAAO,CAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IAEvC,IAAI,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,uHAAuH;QACvH,IAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAEpB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/utils/format.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU;IAEvC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvD,MAAM,OAAO,GAAG,YAAY,GAAG,EAAE,CAAC;IAElC,IAAG,KAAK,GAAG,CAAC,EAAE,CAAC;QAEb,OAAO,CAAE,MAAM,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAChE,CAAC;IAED,IAAG,OAAO,GAAG,CAAC,EAAE,CAAC;QAEf,OAAO,CAAE,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,CAAE,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC;IAE5D,IAAG,OAAO,GAAG,EAAE,EAAE,CAAC;QAEhB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAEzC,IAAG,OAAO,GAAG,EAAE,EAAE,CAAC;QAEhB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IAEvC,IAAG,KAAK,GAAG,EAAE,EAAE,CAAC;QAEd,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;IAEpC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IAEvC,IAAI,CAAC;QAEH,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAElC,uHAAuH;QACvH,IAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAEpB,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QAEP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/utils/index.d.ts

@@ -11,5 +11,6 @@ export * from "./m3u.js";
 export * from "./morganStream.js";
 export * from "./platform.js";
 export * from "./retry.js";
+export * from "./sanitize.js";
 export * from "./streamContext.js";
 export * from "./version.js";

package/dist/utils/index.js

@@ -15,6 +15,7 @@ export * from "./m3u.js";
 export * from "./morganStream.js";
 export * from "./platform.js";
 export * from "./retry.js";
+export * from "./sanitize.js";
 export * from "./streamContext.js";
 export * from "./version.js";
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}

package/dist/utils/sanitize.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Strips non-printable characters from a string and trims whitespace. Replaces `.trim()` at data-collection points to ensure string values contain only visible
+ * content. Safe to call on already-clean strings — the regex replacement is a no-op when no non-printable characters are present.
+ * @param value - The string to sanitize.
+ * @returns The sanitized string with non-printable characters removed and whitespace trimmed.
+ */
+export declare function sanitizeString(value: string): string;
+/**
+ * Tests whether a string contains any non-printable characters. Used for startup warnings when loading persisted data — the warning alerts users to corruption
+ * without modifying the loaded values.
+ * @param value - The string to test.
+ * @returns True if the string contains at least one non-printable character.
+ */
+export declare function containsNonPrintable(value: string): boolean;

package/dist/utils/sanitize.js

@@ -0,0 +1,37 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * sanitize.ts: Input sanitization utilities for PrismCast.
+ */
+/* Non-printable characters can silently corrupt string values when introduced via copy-paste operations or hand-edited JSON files. The most common case is null bytes
+ * (\x00) interleaved between every visible character, which breaks CSS selector matching, URL parsing, and channel identification without any visible indication in
+ * the UI. These utilities strip non-printable characters at data-collection boundaries so downstream code can trust that string values contain only visible content.
+ *
+ * The regex targets control characters and Unicode special characters that have no visible representation: C0 controls (except TAB, LF, CR), DEL, BOM, zero-width
+ * spaces, and Unicode line/paragraph separators. TAB (\x09), LF (\x0A), and CR (\x0D) are preserved because they appear legitimately in multi-line text fields.
+ */
+// Pattern matching non-printable characters. Covers: C0 controls except TAB/LF/CR, DEL, BOM, zero-width spaces, directional markers, and line/paragraph separators.
+// The no-control-regex rule is suppressed because this regex genuinely needs to match control characters — that is its entire purpose.
+// eslint-disable-next-line no-control-regex
+const NON_PRINTABLE_PATTERN = /[\x00-\x08\x0B\x0C\x0E-\x1F\x7F\uFEFF\u200B-\u200F\u2028-\u2029]/g;
+/**
+ * Strips non-printable characters from a string and trims whitespace. Replaces `.trim()` at data-collection points to ensure string values contain only visible
+ * content. Safe to call on already-clean strings — the regex replacement is a no-op when no non-printable characters are present.
+ * @param value - The string to sanitize.
+ * @returns The sanitized string with non-printable characters removed and whitespace trimmed.
+ */
+export function sanitizeString(value) {
+    return value.replace(NON_PRINTABLE_PATTERN, "").trim();
+}
+/**
+ * Tests whether a string contains any non-printable characters. Used for startup warnings when loading persisted data — the warning alerts users to corruption
+ * without modifying the loaded values.
+ * @param value - The string to test.
+ * @returns True if the string contains at least one non-printable character.
+ */
+export function containsNonPrintable(value) {
+    // Reset lastIndex before testing — the global flag on NON_PRINTABLE_PATTERN causes .test() to advance lastIndex on each call, which would produce alternating
+    // true/false results without this reset.
+    NON_PRINTABLE_PATTERN.lastIndex = 0;
+    return NON_PRINTABLE_PATTERN.test(value);
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/utils/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../../src/utils/sanitize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,oKAAoK;AACpK,uIAAuI;AACvI,4CAA4C;AAC5C,MAAM,qBAAqB,GAAG,mEAAmE,CAAC;AAElG;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAE1C,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAEhD,8JAA8J;IAC9J,yCAAyC;IACzC,qBAAqB,CAAC,SAAS,GAAG,CAAC,CAAC;IAEpC,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3C,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "prismcast",
   "displayName": "PrismCast",
-  "version": "1.4.2",
+  "version": "1.5.0",
   "description": "Browser-based live TV capture server for Channels DVR, Plex, and other streaming clients.",
   "author": {
     "name": "HJD",
@@ -63,6 +63,7 @@
     "watch": "npm run build && nodemon"
   },
   "dependencies": {
+    "compression": "^1.8.1",
     "console-stamp": "3.1.2",
     "express": "5.2.1",
     "ffmpeg-for-homebridge": "2.2.1",
@@ -72,15 +73,16 @@
   },
   "devDependencies": {
     "@stylistic/eslint-plugin": "5.9.0",
+    "@types/compression": "^1.8.1",
     "@types/dateformat": "5.0.3",
     "@types/express": "5.0.6",
     "@types/morgan": "1.9.10",
-    "@types/node": "25.3.0",
+    "@types/node": "25.3.3",
     "eslint": "9.39.2",
     "homebridge-plugin-utils": "1.32.0",
     "nodemon": "3.1.14",
     "shx": "0.4.0",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.56.0"
+    "typescript-eslint": "8.56.1"
   }
 }