@bnhf/prismcast 1.3.4-2026.2.19

package/dist/config/profiles.d.ts

@@ -0,0 +1,79 @@
+import { DEFAULT_SITE_PROFILE, DOMAIN_CONFIG, SITE_PROFILES, getDomainConfig } from "./sites.js";
+import type { ProfileCategory, ProfileResolutionResult, ResolvedSiteProfile } from "../types/index.js";
+import type { DomainConfig } from "./sites.js";
+export { DEFAULT_SITE_PROFILE, DOMAIN_CONFIG, SITE_PROFILES, getDomainConfig };
+export type { DomainConfig };
+/**
+ * Resolves a named profile from SITE_PROFILES, handling inheritance and merging with the default profile to ensure all required properties are present. Inheritance
+ * is resolved recursively, with child profile properties overriding parent properties.
+ *
+ * The resolution process:
+ *
+ * 1. Start with a copy of DEFAULT_SITE_PROFILE
+ * 2. If the profile extends another, recursively resolve the parent and merge its properties
+ * 3. Merge the current profile's properties, overriding any inherited values
+ * 4. Return the fully-resolved profile with all flags set
+ *
+ * Metadata properties (description, extends) are stripped during resolution - they exist only for documentation and inheritance specification.
+ *
+ * @param profileName - The name of the profile to resolve.
+ * @returns The merged site profile containing all behavior flags.
+ */
+export declare function resolveProfile(profileName: string | undefined): ResolvedSiteProfile;
+/**
+ * Resolves the site profile for a given URL by looking it up in DOMAIN_CONFIG via getDomainConfig(), which tries the full hostname first for subdomain-specific
+ * overrides before falling back to the concise domain. Falls back to the default profile if no matching domain is found or the matching domain has no profile
+ * configured.
+ * @param url - The URL to resolve a profile for.
+ * @returns The site profile containing behavior flags.
+ */
+export declare function getProfileForUrl(url: string | undefined): ProfileResolutionResult;
+/**
+ * Resolves the site profile for a channel. Channels can explicitly declare their profile by name, which takes precedence over URL-based detection. This is useful
+ * when:
+ * - A channel's URL domain doesn't match the expected behavior pattern
+ * - The same domain serves multiple channel types needing different handling
+ * - A channel needs a custom combination of flags not covered by existing profiles
+ *
+ * The special value "auto" triggers URL-based domain detection, equivalent to omitting the profile property. This allows channels to explicitly opt into domain
+ * detection rather than relying on the implicit behavior of an absent property.
+ *
+ * Channel-specific properties like channelSelector are merged into the resolved profile, allowing channels to extend profiles with additional configuration.
+ *
+ * @param channel - The channel object with url and optional profile properties.
+ * @returns The site profile containing behavior flags.
+ */
+export declare function getProfileForChannel(channel: {
+    channelSelector?: string;
+    profile?: string;
+    url?: string;
+} | undefined): ProfileResolutionResult;
+/**
+ * Validates all profile configurations including inheritance chains, domain mappings, and channel references. Throws an error if any validation fails. This
+ * function runs at startup before the server begins accepting connections.
+ *
+ * Validation checks:
+ *
+ * 1. Circular inheritance detection - walks the extends chain for each profile to detect cycles
+ * 2. Invalid extends references - ensures all extends targets exist
+ * 3. Domain mapping validation - ensures all domain profile references exist
+ * 4. Channel profile validation - ensures all channel profile references exist
+ *
+ * @throws If any profile configuration is invalid.
+ */
+export declare function validateProfiles(): void;
+/**
+ * Profile information for UI display, including name, description, category, and summary.
+ */
+export interface ProfileInfo {
+    category: ProfileCategory;
+    description: string;
+    name: string;
+    summary: string;
+}
+/**
+ * Returns all profiles with their descriptions, categories, and summaries, sorted alphabetically by name. Used by the channel configuration UI to populate the
+ * profile dropdown with tooltips and the profile reference section.
+ * @returns Array of profile info objects.
+ */
+export declare function getProfiles(): ProfileInfo[];

package/dist/config/profiles.js

@@ -0,0 +1,245 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * profiles.ts: Site profile resolution and validation for PrismCast.
+ */
+import { DEFAULT_SITE_PROFILE, DOMAIN_CONFIG, SITE_PROFILES, getDomainConfig } from "./sites.js";
+import { CHANNELS } from "../channels/index.js";
+import { extractDomain } from "../utils/index.js";
+// Re-export site data so existing consumers can import from either module.
+export { DEFAULT_SITE_PROFILE, DOMAIN_CONFIG, SITE_PROFILES, getDomainConfig };
+/* Profile resolution is the process of determining which behavior flags to use for a given stream. The resolution process handles inheritance, merging parent and
+ * child profile properties, and falling back to defaults for unspecified flags.
+ *
+ * Resolution order (highest to lowest priority):
+ *
+ * 1. Channel's explicit profile property (if specified)
+ * 2. URL-based detection via DOMAIN_CONFIG
+ * 3. DEFAULT_SITE_PROFILE
+ *
+ * Within a profile, inheritance works as follows:
+ *
+ * 1. Start with DEFAULT_SITE_PROFILE for base values
+ * 2. Apply parent profile properties (if extends is set)
+ * 3. Apply current profile properties (overriding parent)
+ *
+ * This allows profiles like "embeddedDynamicMultiVideo" to inherit iframe handling from "embeddedPlayer" which inherits API fullscreen from "fullscreenApi",
+ * building up the complete set of behavior flags through the inheritance chain.
+ */
+/**
+ * Resolves a named profile from SITE_PROFILES, handling inheritance and merging with the default profile to ensure all required properties are present. Inheritance
+ * is resolved recursively, with child profile properties overriding parent properties.
+ *
+ * The resolution process:
+ *
+ * 1. Start with a copy of DEFAULT_SITE_PROFILE
+ * 2. If the profile extends another, recursively resolve the parent and merge its properties
+ * 3. Merge the current profile's properties, overriding any inherited values
+ * 4. Return the fully-resolved profile with all flags set
+ *
+ * Metadata properties (description, extends) are stripped during resolution - they exist only for documentation and inheritance specification.
+ *
+ * @param profileName - The name of the profile to resolve.
+ * @returns The merged site profile containing all behavior flags.
+ */
+export function resolveProfile(profileName) {
+    // No profile specified - return the default.
+    if (!profileName) {
+        return { ...DEFAULT_SITE_PROFILE };
+    }
+    // The conditional below guards against runtime scenarios where profileName is not in SITE_PROFILES, even though TypeScript's Record type doesn't capture this.
+    // This can happen if a channel references a typo'd profile name or if profiles are modified at runtime.
+    const profile = SITE_PROFILES[profileName];
+    if (!profile) {
+        return { ...DEFAULT_SITE_PROFILE };
+    }
+    // Start with default values. This ensures all flags have a value even if not specified in the profile.
+    let resolved = { ...DEFAULT_SITE_PROFILE };
+    // Apply parent profile first if inheritance exists. This allows child profiles to override parent properties while inheriting the rest.
+    if (profile.extends) {
+        const parent = resolveProfile(profile.extends);
+        resolved = { ...resolved, ...parent };
+    }
+    // Apply current profile properties, excluding metadata fields that should not be in the resolved profile. The category, description, extends, and summary
+    // properties are for UI categorization, documentation, inheritance specification, and UI display only.
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    const { category: _category, description: _description, extends: _extends, summary: _summary, ...profileFlags } = profile;
+    resolved = { ...resolved, ...profileFlags };
+    return resolved;
+}
+/**
+ * Resolves the site profile for a given URL by looking it up in DOMAIN_CONFIG via getDomainConfig(), which tries the full hostname first for subdomain-specific
+ * overrides before falling back to the concise domain. Falls back to the default profile if no matching domain is found or the matching domain has no profile
+ * configured.
+ * @param url - The URL to resolve a profile for.
+ * @returns The site profile containing behavior flags.
+ */
+export function getProfileForUrl(url) {
+    // No URL provided - return the default.
+    if (!url) {
+        return { profile: { ...DEFAULT_SITE_PROFILE }, profileName: "default" };
+    }
+    // Look up the domain configuration, trying the full hostname first for subdomain-specific overrides (e.g., "tv.youtube.com" before "youtube.com").
+    const config = getDomainConfig(url);
+    // Resolve the profile from the domain configuration, falling back to the default profile for unrecognized domains or domains without a profile entry.
+    const profile = config?.profile ? resolveProfile(config.profile) : { ...DEFAULT_SITE_PROFILE };
+    const profileName = config?.profile ?? "default";
+    // Merge domain-level properties that represent site policies rather than player behaviors. maxContinuousPlayback is a site-imposed session limit, not a player
+    // characteristic, so it lives in DOMAIN_CONFIG rather than in site profiles. Note: getProfileForChannel() performs this same merge for the explicit-profile path
+    // where this function is bypassed. If adding new domain-level policies here, update getProfileForChannel() as well.
+    if (config?.maxContinuousPlayback !== undefined) {
+        profile.maxContinuousPlayback = config.maxContinuousPlayback;
+    }
+    return { profile, profileName };
+}
+/**
+ * Resolves the site profile for a channel. Channels can explicitly declare their profile by name, which takes precedence over URL-based detection. This is useful
+ * when:
+ * - A channel's URL domain doesn't match the expected behavior pattern
+ * - The same domain serves multiple channel types needing different handling
+ * - A channel needs a custom combination of flags not covered by existing profiles
+ *
+ * The special value "auto" triggers URL-based domain detection, equivalent to omitting the profile property. This allows channels to explicitly opt into domain
+ * detection rather than relying on the implicit behavior of an absent property.
+ *
+ * Channel-specific properties like channelSelector are merged into the resolved profile, allowing channels to extend profiles with additional configuration.
+ *
+ * @param channel - The channel object with url and optional profile properties.
+ * @returns The site profile containing behavior flags.
+ */
+export function getProfileForChannel(channel) {
+    // No channel provided - return the default.
+    if (!channel) {
+        return { profile: { ...DEFAULT_SITE_PROFILE }, profileName: "default" };
+    }
+    let profile;
+    let profileName;
+    // If the channel specifies an explicit profile name, use it directly. This takes precedence over URL-based detection. The value "auto" is treated as unset,
+    // falling through to URL-based detection below.
+    if (channel.profile && (channel.profile !== "auto")) {
+        profile = resolveProfile(channel.profile);
+        profileName = channel.profile;
+    }
+    else if (channel.url) {
+        // Fall back to URL-based profile detection.
+        const result = getProfileForUrl(channel.url);
+        profile = result.profile;
+        profileName = result.profileName;
+    }
+    else {
+        profile = { ...DEFAULT_SITE_PROFILE };
+        profileName = "default";
+    }
+    // If the resolved profile requires channel selection (strategy other than "none") but the channel has no channelSelector, the hostname-specific domain entry
+    // (e.g., watch.sling.com → slingLive) is not appropriate for this direct-URL channel. Fall back to the concise domain entry (e.g., sling.com →
+    // embeddedVolumeLock) which provides generic player handling for direct URLs on the same service.
+    if ((profile.channelSelection.strategy !== "none") && !channel.channelSelector && channel.url) {
+        const conciseConfig = DOMAIN_CONFIG[extractDomain(channel.url)];
+        if (conciseConfig?.profile && (conciseConfig.profile !== profileName)) {
+            profile = resolveProfile(conciseConfig.profile);
+            profileName = conciseConfig.profile;
+        }
+    }
+    // Merge domain-level site policies that apply regardless of how the profile was resolved. These represent site-imposed constraints (like session duration limits)
+    // rather than player behaviors, so they must always be applied based on the channel's URL even when the player profile is explicitly overridden. For the URL-based
+    // path above, getProfileForUrl() already merges these — the re-application here is idempotent. For the explicit-profile path, this fills the gap.
+    if (channel.url) {
+        const domainConfig = getDomainConfig(channel.url);
+        if (domainConfig?.maxContinuousPlayback !== undefined) {
+            profile = { ...profile, maxContinuousPlayback: domainConfig.maxContinuousPlayback };
+        }
+    }
+    // Merge channel-specific properties into the profile. Currently only channelSelector is supported, which specifies a CSS selector for the channel button in
+    // multi-channel player pages. The channelSelector on the channel overrides any channelSelector from the profile.
+    if (channel.channelSelector) {
+        profile = { ...profile, channelSelector: channel.channelSelector };
+    }
+    return { profile, profileName };
+}
+/* Before starting the server, we validate all profile configurations to catch errors early. Invalid configurations would cause runtime failures that are difficult
+ * to diagnose:
+ *
+ * - Invalid profile references (typos in extends or profile properties)
+ * - Circular inheritance chains (A extends B extends A)
+ * - Domain mappings pointing to non-existent profiles
+ * - Channel definitions referencing non-existent profiles
+ *
+ * By validating upfront at startup, we provide clear error messages and prevent the server from starting in a misconfigured state. This is especially important
+ * because profile errors might not surface until a specific channel is streamed, which could be hours after startup.
+ */
+/**
+ * Validates all profile configurations including inheritance chains, domain mappings, and channel references. Throws an error if any validation fails. This
+ * function runs at startup before the server begins accepting connections.
+ *
+ * Validation checks:
+ *
+ * 1. Circular inheritance detection - walks the extends chain for each profile to detect cycles
+ * 2. Invalid extends references - ensures all extends targets exist
+ * 3. Domain mapping validation - ensures all domain profile references exist
+ * 4. Channel profile validation - ensures all channel profile references exist
+ *
+ * @throws If any profile configuration is invalid.
+ */
+export function validateProfiles() {
+    const errors = [];
+    // Check for circular inheritance and invalid extends references in profiles. We walk the extends chain for each profile, tracking visited profiles to detect
+    // cycles.
+    for (const profileName of Object.keys(SITE_PROFILES)) {
+        const visited = new Set();
+        let current = profileName;
+        while (current) {
+            // If we've seen this profile before, we have a circular reference.
+            if (visited.has(current)) {
+                errors.push(["Circular inheritance detected in profile: ", profileName].join(""));
+                break;
+            }
+            visited.add(current);
+            // TypeScript's Record type doesn't capture that the key may not exist at runtime.
+            const profile = SITE_PROFILES[current];
+            current = profile?.extends;
+            // Check if the extends target exists. This catches typos and references to deleted profiles.
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            if ((current !== undefined) && !SITE_PROFILES[current]) {
+                errors.push(["Profile ", profileName, " extends non-existent profile: ", current].join(""));
+                break;
+            }
+        }
+    }
+    // Validate all domain-to-profile mappings reference existing profiles. This catches typos in DOMAIN_CONFIG profile entries.
+    for (const [domain, config] of Object.entries(DOMAIN_CONFIG)) {
+        if (config.profile) {
+            const domainProfile = SITE_PROFILES[config.profile];
+            if (!domainProfile) {
+                errors.push(["Domain ", domain, " references non-existent profile: ", config.profile].join(""));
+            }
+        }
+    }
+    // Validate all channel profile references point to existing profiles. This catches typos in channel definitions.
+    for (const [channelName, channel] of Object.entries(CHANNELS)) {
+        const channelProfile = channel.profile;
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+        if ((channelProfile !== undefined) && (channelProfile !== "auto") && !SITE_PROFILES[channelProfile]) {
+            errors.push(["Channel ", channelName, " references non-existent profile: ", channelProfile].join(""));
+        }
+    }
+    // If any errors were found, throw with all error messages for comprehensive feedback.
+    if (errors.length > 0) {
+        throw new Error(["Profile validation failed:\n  ", errors.join("\n  ")].join(""));
+    }
+}
+/**
+ * Returns all profiles with their descriptions, categories, and summaries, sorted alphabetically by name. Used by the channel configuration UI to populate the
+ * profile dropdown with tooltips and the profile reference section.
+ * @returns Array of profile info objects.
+ */
+export function getProfiles() {
+    return Object.keys(SITE_PROFILES).sort().map((name) => {
+        const profile = SITE_PROFILES[name];
+        return {
+            category: profile.category ?? "special",
+            description: profile.description ?? "",
+            name,
+            summary: profile.summary ?? profile.description ?? ""
+        };
+    });
+}
+//# sourceMappingURL=profiles.js.map

package/dist/config/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/config/profiles.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjG,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,2EAA2E;AAC3E,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,CAAC;AAG/E;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,WAA+B;IAE5D,6CAA6C;IAC7C,IAAG,CAAC,WAAW,EAAE,CAAC;QAEhB,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAED,+JAA+J;IAC/J,wGAAwG;IACxG,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAA4B,CAAC;IAEtE,IAAG,CAAC,OAAO,EAAE,CAAC;QAEZ,OAAO,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACrC,CAAC;IAED,uGAAuG;IACvG,IAAI,QAAQ,GAAwB,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAEhE,wIAAwI;IACxI,IAAG,OAAO,CAAC,OAAO,EAAE,CAAC;QAEnB,MAAM,MAAM,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAE/C,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,EAAE,CAAC;IACxC,CAAC;IAED,0JAA0J;IAC1J,uGAAuG;IACvG,6DAA6D;IAC7D,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,YAAY,EAAE,GAAG,OAAO,CAAC;IAE1H,QAAQ,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,YAAY,EAAE,CAAC;IAE5C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAuB;IAEtD,wCAAwC;IACxC,IAAG,CAAC,GAAG,EAAE,CAAC;QAER,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,oBAAoB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC1E,CAAC;IAED,mJAAmJ;IACnJ,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAEpC,sJAAsJ;IACtJ,MAAM,OAAO,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC/F,MAAM,WAAW,GAAG,MAAM,EAAE,OAAO,IAAI,SAAS,CAAC;IAEjD,+JAA+J;IAC/J,iKAAiK;IACjK,oHAAoH;IACpH,IAAG,MAAM,EAAE,qBAAqB,KAAK,SAAS,EAAE,CAAC;QAE/C,OAAO,CAAC,qBAAqB,GAAG,MAAM,CAAC,qBAAqB,CAAC;IAC/D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAiF;IAEpH,4CAA4C;IAC5C,IAAG,CAAC,OAAO,EAAE,CAAC;QAEZ,OAAO,EAAE,OAAO,EAAE,EAAE,GAAG,oBAAoB,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;IAC1E,CAAC;IAED,IAAI,OAA4B,CAAC;IACjC,IAAI,WAAmB,CAAC;IAExB,4JAA4J;IAC5J,gDAAgD;IAChD,IAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,KAAK,MAAM,CAAC,EAAE,CAAC;QAEnD,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1C,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAChC,CAAC;SAAM,IAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEtB,4CAA4C;QAC5C,MAAM,MAAM,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAE7C,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACzB,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IACnC,CAAC;SAAM,CAAC;QAEN,OAAO,GAAG,EAAE,GAAG,oBAAoB,EAAE,CAAC;QACtC,WAAW,GAAG,SAAS,CAAC;IAC1B,CAAC;IAED,6JAA6J;IAC7J,+IAA+I;IAC/I,kGAAkG;IAClG,IAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,QAAQ,KAAK,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAE7F,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAA6B,CAAC;QAE5F,IAAG,aAAa,EAAE,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,KAAK,WAAW,CAAC,EAAE,CAAC;YAErE,OAAO,GAAG,cAAc,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAChD,WAAW,GAAG,aAAa,CAAC,OAAO,CAAC;QACtC,CAAC;IACH,CAAC;IAED,kKAAkK;IAClK,mKAAmK;IACnK,kJAAkJ;IAClJ,IAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAEf,MAAM,YAAY,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAElD,IAAG,YAAY,EAAE,qBAAqB,KAAK,SAAS,EAAE,CAAC;YAErD,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,qBAAqB,EAAE,YAAY,CAAC,qBAAqB,EAAE,CAAC;QACtF,CAAC;IACH,CAAC;IAED,4JAA4J;IAC5J,iHAAiH;IACjH,IAAG,OAAO,CAAC,eAAe,EAAE,CAAC;QAE3B,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IACrE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAClC,CAAC;AAED;;;;;;;;;;GAUG;AAEH;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB;IAE9B,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,6JAA6J;IAC7J,UAAU;IACV,KAAI,MAAM,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAEpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;QAClC,IAAI,OAAO,GAAuB,WAAW,CAAC;QAE9C,OAAM,OAAO,EAAE,CAAC;YAEd,mEAAmE;YACnE,IAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBAExB,MAAM,CAAC,IAAI,CAAC,CAAE,4CAA4C,EAAE,WAAW,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAEpF,MAAM;YACR,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YAErB,kFAAkF;YAClF,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,CAA4B,CAAC;YAElE,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC;YAE3B,6FAA6F;YAC7F,uEAAuE;YACvE,IAAG,CAAC,OAAO,KAAK,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;gBAEtD,MAAM,CAAC,IAAI,CAAC,CAAE,UAAU,EAAE,WAAW,EAAE,iCAAiC,EAAE,OAAO,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAE9F,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,4HAA4H;IAC5H,KAAI,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QAE9D,IAAG,MAAM,CAAC,OAAO,EAAE,CAAC;YAElB,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,CAA4B,CAAC;YAE/E,IAAG,CAAC,aAAa,EAAE,CAAC;gBAElB,MAAM,CAAC,IAAI,CAAC,CAAE,SAAS,EAAE,MAAM,EAAE,oCAAoC,EAAE,MAAM,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;YACpG,CAAC;QACH,CAAC;IACH,CAAC;IAED,iHAAiH;IACjH,KAAI,MAAM,CAAE,WAAW,EAAE,OAAO,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE/D,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;QAEvC,uEAAuE;QACvE,IAAG,CAAC,cAAc,KAAK,SAAS,CAAC,IAAI,CAAC,cAAc,KAAK,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,EAAE,CAAC;YAEnG,MAAM,CAAC,IAAI,CAAC,CAAE,UAAU,EAAE,WAAW,EAAE,oCAAoC,EAAE,cAAc,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1G,CAAC;IACH,CAAC;IAED,sFAAsF;IACtF,IAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAErB,MAAM,IAAI,KAAK,CAAC,CAAE,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAE,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACtF,CAAC;AACH,CAAC;AAuBD;;;;GAIG;AACH,MAAM,UAAU,WAAW;IAEzB,OAAO,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAEpC,OAAO;YAEL,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,SAAS;YACvC,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,IAAI;YACJ,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,WAAW,IAAI,EAAE;SACtD,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/config/providers.d.ts

@@ -0,0 +1,120 @@
+import type { Channel, ChannelMap, ProviderGroup } from "../types/index.js";
+/**
+ * Gets the provider tag for a channel key. For variant keys (e.g., "espn-hulu"), extracts the suffix after the canonical prefix (e.g., "hulu"). For canonical keys,
+ * looks up the URL domain via getDomainConfig() and reads the providerTag field, falling back to "direct" if not found.
+ * @param key - The channel key.
+ * @returns The provider tag string.
+ */
+export declare function getProviderTagForChannel(key: string): string;
+/**
+ * Returns all provider tags for a channel (canonical tag + all variant suffix tags). Used to determine which providers offer this channel.
+ * @param canonicalKey - The canonical channel key.
+ * @returns Array of provider tag strings.
+ */
+export declare function getChannelProviderTags(canonicalKey: string): string[];
+/**
+ * Scans all provider groups and collects unique provider tags with display names. Display names are derived from the provider field in DOMAIN_CONFIG entries that
+ * have a providerTag, with any trailing parenthetical stripped (e.g., "Hulu (Live Guide)" becomes "Hulu").
+ * @returns Array of { displayName, tag } objects sorted alphabetically by display name, with "direct" always first.
+ */
+export declare function getAllProviderTags(): {
+    displayName: string;
+    tag: string;
+}[];
+/**
+ * Gets the current enabled provider tags.
+ * @returns Copy of the enabled providers array. Empty means no filter (all shown).
+ */
+export declare function getEnabledProviders(): string[];
+/**
+ * Sets the enabled provider tags. Empty array means "no filter" (all providers shown).
+ * @param tags - The provider tags to enable.
+ */
+export declare function setEnabledProviders(tags: string[]): void;
+/**
+ * Checks if a provider tag is currently enabled. Returns true if the tag is enabled, if no filter is active (empty set), or if the tag is "direct".
+ * @param tag - The provider tag to check.
+ * @returns True if the provider is available.
+ */
+export declare function isProviderTagEnabled(tag: string): boolean;
+/**
+ * Centralized availability check for the provider filter. Returns true if the channel has at least one variant whose provider tag is enabled.
+ * @param canonicalKey - The canonical channel key.
+ * @returns True if the channel passes the provider filter.
+ */
+export declare function isChannelAvailableByProvider(canonicalKey: string): boolean;
+/**
+ * Builds provider groups by scanning all channels and grouping them by key patterns. A key like "espn-disneyplus" is a variant of "espn" because it starts with
+ * "espn-". Should be called at startup after channels are loaded.
+ * @param channels - The merged channel map (predefined + user channels).
+ */
+export declare function buildProviderGroups(channels: ChannelMap): void;
+/**
+ * Resolves a URL to a friendly provider display name. Checks DOMAIN_CONFIG via getDomainConfig() for a provider name, trying the full hostname first for
+ * subdomain-specific overrides before falling back to the concise domain. Returns the raw domain string if no provider name is configured.
+ * @param url - The URL to resolve a provider display name for.
+ * @returns The provider display name, or the concise domain if no provider name is configured.
+ */
+export declare function getProviderDisplayName(url: string): string;
+/**
+ * Gets the provider group for a channel key. Works with both canonical and variant keys.
+ * @param key - Any channel key in the group.
+ * @returns The provider group if the channel is part of a multi-provider group, undefined otherwise.
+ */
+export declare function getProviderGroup(key: string): ProviderGroup | undefined;
+/**
+ * Checks if a channel key is a non-canonical provider variant. Used to filter variants from channel listings.
+ * @param key - The channel key to check.
+ * @returns True if the key is a variant (not canonical) in a provider group.
+ */
+export declare function isProviderVariant(key: string): boolean;
+/**
+ * Checks if a channel has multiple provider options. Used to determine whether to show a provider dropdown in the UI.
+ * @param key - The channel key to check.
+ * @returns True if the channel has more than one provider variant.
+ */
+export declare function hasMultipleProviders(key: string): boolean;
+/**
+ * Gets the canonical key for any channel key. For variant keys, returns the canonical key. For non-grouped or canonical keys, returns the input unchanged.
+ * Handles the PREDEFINED_SUFFIX used when a user has overridden a predefined channel.
+ * @param key - Any channel key.
+ * @returns The canonical key for the channel's provider group, or the input key if not part of a group.
+ */
+export declare function getCanonicalKey(key: string): string;
+/**
+ * Sets the user's provider selections. Called when loading from channels.json.
+ * @param selections - Provider selections keyed by canonical channel key.
+ */
+export declare function setProviderSelections(selections: Record<string, string>): void;
+/**
+ * Gets all provider selections.
+ * @returns Copy of the provider selections object.
+ */
+export declare function getProviderSelections(): Record<string, string>;
+/**
+ * Gets the provider selection for a specific channel.
+ * @param canonicalKey - The canonical channel key.
+ * @returns The selected provider key, or undefined if using the default.
+ */
+export declare function getProviderSelection(canonicalKey: string): string | undefined;
+/**
+ * Sets the provider selection for a channel.
+ * @param canonicalKey - The canonical channel key.
+ * @param providerKey - The selected provider key.
+ */
+export declare function setProviderSelection(canonicalKey: string, providerKey: string): void;
+/**
+ * Resolves a canonical channel key to the actual channel key based on user selection. If the user has selected a specific provider for this channel, returns that
+ * provider's key. Otherwise returns the canonical key (default provider). When the provider filter is active, falls back to the first enabled variant if the stored
+ * selection's provider is filtered out.
+ * @param canonicalKey - The canonical channel key.
+ * @returns The resolved provider key to use for streaming.
+ */
+export declare function resolveProviderKey(canonicalKey: string): string;
+/**
+ * Gets a channel with inheritance applied. For provider variants, this merges the variant's properties with inherited properties from the canonical entry.
+ * Inherited properties: `name`, `stationId` (variant takes precedence). `channelSelector` is not inherited — it is provider-specific.
+ * @param key - The channel key (canonical or variant).
+ * @returns The complete channel with inheritance applied, or undefined if the channel doesn't exist.
+ */
+export declare function getResolvedChannel(key: string): Channel | undefined;