prismcast 1.8.0 → 1.9.0

package/dist/config/persistence.js

@@ -0,0 +1,127 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * persistence.ts: Transactional file store for PrismCast configuration persistence.
+ */
+import { LOG, stringifySorted } from "../utils/index.js";
+import fs from "node:fs";
+import { getDataDir } from "./paths.js";
+const { promises: fsPromises } = fs;
+/**
+ * Error thrown by `mutate()` when the backing file contains invalid JSON. Route handlers can catch this specifically to return 400 instead of 500. Background code
+ * paths that swallow errors via try/catch will handle it like any other Error.
+ */
+export class FileStoreParseError extends Error {
+    name = "FileStoreParseError";
+    constructor(label, filePath, parseMessage) {
+        super("Cannot modify " + label + " (" + filePath + "): file contains invalid JSON. " + parseMessage);
+    }
+}
+// Store factory.
+/**
+ * Creates a transactional file store instance. Each instance owns a single JSON file and provides serialized, atomic access to it.
+ *
+ * Safety guarantees:
+ * - **Atomic writes:** data is written to a `.tmp` file and renamed over the original. `rename()` is atomic on POSIX and NTFS.
+ * - **Serialization:** a promise chain ensures only one `mutate()` runs at a time. Concurrent callers queue behind the active operation.
+ * - **Corruption guard:** `mutate()` throws `FileStoreParseError` if the file contains invalid JSON, preventing save-over-corrupt cascades.
+ * - **Backup rotation:** before each write, the current file is copied to `.bak`. One-deep rotation provides a recovery path.
+ *
+ * @template T - The in-memory data type that callers mutate.
+ * @param options - Store configuration.
+ * @returns A FileStore instance with `read()` and `mutate()` methods.
+ */
+export function createFileStore(options) {
+    // Serialization queue. Each mutate() call chains onto this promise so operations execute one at a time.
+    let queue = Promise.resolve();
+    // Lazy data directory creation. The directory is created once on the first write, then skipped for subsequent writes.
+    let dataDirEnsured = false;
+    /**
+     * Reads the file from disk and parses it. Handles missing files (normal on first run), parse errors, and other read failures.
+     */
+    async function read() {
+        const filePath = options.path();
+        try {
+            const content = await fsPromises.readFile(filePath, "utf-8");
+            try {
+                const data = options.parse(content);
+                return { data, parseError: false };
+            }
+            catch (parseError) {
+                const message = (parseError instanceof Error) ? parseError.message : String(parseError);
+                LOG.warn("Invalid JSON in %s file %s: %s. Using defaults.", options.label, filePath, message);
+                return { data: options.defaultValue(), parseError: true, parseErrorMessage: message };
+            }
+        }
+        catch (error) {
+            // File doesn't exist...this is normal on first run, use defaults.
+            if (error.code === "ENOENT") {
+                return { data: options.defaultValue(), parseError: false };
+            }
+            // Other read errors...log and use defaults.
+            LOG.warn("Failed to read %s file %s: %s. Using defaults.", options.label, filePath, (error instanceof Error) ? error.message : String(error));
+            return { data: options.defaultValue(), parseError: false };
+        }
+    }
+    /**
+     * Executes a single mutation: read, guard, mutate, backup, atomic write. Called under the serialization queue.
+     */
+    async function doMutate(fn) {
+        const filePath = options.path();
+        // Read the current file state.
+        const result = await read();
+        // Corruption guard: refuse to modify a file that can't be parsed. This prevents the cascade where a corrupt file gets overwritten with nearly-empty data.
+        if (result.parseError) {
+            throw new FileStoreParseError(options.label, filePath, result.parseErrorMessage ?? "Unknown parse error.");
+        }
+        // Apply the caller's mutation. Callbacks modify data in place.
+        fn(result.data);
+        // Apply the beforeWrite transform to produce the serializable form.
+        const serializable = options.beforeWrite ? options.beforeWrite(result.data) : result.data;
+        const content = stringifySorted(serializable) + "\n";
+        // Ensure the data directory exists on the first write.
+        if (!dataDirEnsured) {
+            await fsPromises.mkdir(getDataDir(), { recursive: true });
+            dataDirEnsured = true;
+        }
+        // Backup: copy the current file to .bak before overwriting. Swallow ENOENT (file doesn't exist yet on first write).
+        const bakPath = filePath + ".bak";
+        try {
+            await fsPromises.copyFile(filePath, bakPath);
+        }
+        catch (backupError) {
+            if (backupError.code !== "ENOENT") {
+                LOG.warn("Failed to back up %s: %s.", filePath, (backupError instanceof Error) ? backupError.message : String(backupError));
+            }
+        }
+        // Atomic write: write to a temp file, then rename over the original. rename() is atomic on POSIX and NTFS filesystems.
+        const tmpPath = filePath + ".tmp";
+        try {
+            await fsPromises.writeFile(tmpPath, content, "utf-8");
+            await fsPromises.rename(tmpPath, filePath);
+        }
+        catch (writeError) {
+            // Attempt cleanup of the temp file on failure.
+            try {
+                await fsPromises.unlink(tmpPath);
+            }
+            catch {
+                // Cleanup is best-effort.
+            }
+            throw writeError;
+        }
+        LOG.info("Saved %s to %s.", options.label, filePath);
+    }
+    /**
+     * Enqueues a mutation onto the serialization queue. The promise chain ensures only one mutation runs at a time. Errors propagate to the caller but do not
+     * break the chain for subsequent callers.
+     */
+    async function mutate(fn) {
+        const operation = queue.then(async () => doMutate(fn));
+        // Swallow errors on the chain reference so future operations can proceed. The error still propagates to the caller via the returned promise.
+        // eslint-disable-next-line @typescript-eslint/no-empty-function -- Intentional no-op: errors are propagated to the caller via the returned promise.
+        queue = operation.catch(() => { });
+        return operation;
+    }
+    return { mutate, read };
+}
+//# sourceMappingURL=persistence.js.map

package/dist/config/persistence.js.map

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

package/dist/config/servicePacks.d.ts

@@ -0,0 +1,46 @@
+import type { ServicePack } from "../types/index.js";
+/**
+ * Result of parsing a service pack.
+ */
+export interface ParseResult {
+    errors: string[];
+    pack?: ServicePack;
+}
+/**
+ * Summary of what was imported from a service pack. The primary import (profiles and domains) is tracked separately from the secondary channel import so that
+ * callers can report partial success accurately — profiles may save while channels fail.
+ */
+export interface ImportSummary {
+    channelsAdded: number;
+    domainsAdded: number;
+    errors: string[];
+    profilesAdded: number;
+    success: boolean;
+}
+/**
+ * Parses and validates a raw service pack import. Checks the version field, validates profiles and domains via the userProfiles validation functions.
+ * @param data - The raw JSON data to parse.
+ * @returns Parse result with validated pack or errors.
+ */
+export declare function parseServicePack(data: unknown): ParseResult;
+/**
+ * Imports a validated service pack by writing its contents to profiles.json and optionally channels.json. Returns a summary of what was added.
+ * @param pack - The validated service pack to import.
+ * @param options - Import options. Set skipChannels to true to skip importing channels even if the pack contains them.
+ * @returns Summary of what was imported.
+ */
+export declare function importServicePack(pack: ServicePack, options?: {
+    skipChannels?: boolean;
+}): Promise<ImportSummary>;
+/**
+ * Exports one or more user profiles and their associated domain mappings as a service pack JSON object. Optionally includes channels that reference the
+ * selected profiles.
+ * @param profileKeys - Array of user profile keys to export.
+ * @param options - Export options controlling what to include.
+ * @returns The service pack object, or null if none of the requested profiles exist.
+ */
+export declare function exportServicePack(profileKeys: string[], options?: {
+    includeChannels?: boolean;
+    includeDomains?: boolean;
+    name?: string;
+}): ServicePack | null;

package/dist/config/{providerPacks.js → servicePacks.js}

@@ -1,17 +1,17 @@
-import { getChannelListing, loadUserChannels, saveUserChannels } from "./userChannels.js";
-import { getUserDomains, getUserProfiles, saveUserProfiles, validateImportedProfiles } from "./userProfiles.js";
+import { getChannelListing, mutateChannels } from "./userChannels.js";
+import { getUserDomains, getUserProfiles, mutateProfiles, normalizeLegacyProfileFlags, validateImportedProfiles } from "./userProfiles.js";
 import { sanitizeString } from "../utils/index.js";
-/* Provider packs bundle a profile, domain mapping(s), and optionally channels into a single JSON file for distribution. On import, the contents are validated
+/* Service packs bundle a profile, domain mapping(s), and optionally channels into a single JSON file for distribution. On import, the contents are validated
  * and split into profiles.json and channels.json. On export, a user profile and its associated domain mappings and channels are packaged for sharing.
  */
-// Current provider pack format version.
+// Current service pack format version.
 const CURRENT_VERSION = 1;
 /**
- * Parses and validates a raw provider pack import. Checks the version field, validates profiles and domains via the userProfiles validation functions.
+ * Parses and validates a raw service pack import. Checks the version field, validates profiles and domains via the userProfiles validation functions.
  * @param data - The raw JSON data to parse.
  * @returns Parse result with validated pack or errors.
  */
-export function parseProviderPack(data) {
+export function parseServicePack(data) {
     const errors = [];
     if ((typeof data !== "object") || (data === null) || Array.isArray(data)) {
         return { errors: ["Invalid format: expected a JSON object."] };
@@ -37,10 +37,13 @@ export function parseProviderPack(data) {
     if (errors.length > 0) {
         return { errors };
     }
+    // Normalize legacy profile field names before validation so that old service packs with renamed fields (e.g., noVideo → staticCapture) pass validation cleanly.
+    const rawProfiles = raw.profiles;
+    normalizeLegacyProfileFlags(rawProfiles);
     // Validate the profiles and domains using the shared validation pipeline.
     const validationResult = validateImportedProfiles({
         domains: raw.domains,
-        profiles: raw.profiles
+        profiles: rawProfiles
     });
     if (!validationResult.valid) {
         return { errors: validationResult.errors };
@@ -52,7 +55,7 @@ export function parseProviderPack(data) {
             errors.push("Invalid 'channels' field: expected an object.");
         }
         else {
-            // Basic channel structure validation — detailed validation happens during importProviderPack.
+            // Basic channel structure validation — detailed validation happens during importServicePack.
             for (const [key, value] of Object.entries(raw.channels)) {
                 if ((typeof value === "object") && (value !== null) && !Array.isArray(value)) {
                     const ch = value;
@@ -95,22 +98,20 @@ export function parseProviderPack(data) {
     return { errors: [], pack };
 }
 /**
- * Imports a validated provider pack by writing its contents to profiles.json and optionally channels.json. Returns a summary of what was added.
- * @param pack - The validated provider pack to import.
+ * Imports a validated service pack by writing its contents to profiles.json and optionally channels.json. Returns a summary of what was added.
+ * @param pack - The validated service pack to import.
  * @param options - Import options. Set skipChannels to true to skip importing channels even if the pack contains them.
  * @returns Summary of what was imported.
  */
-export async function importProviderPack(pack, options = {}) {
+export async function importServicePack(pack, options = {}) {
     const errors = [];
-    // Merge profiles: add pack profiles to existing user profiles.
-    const existingProfiles = getUserProfiles();
-    const existingDomains = getUserDomains();
-    const mergedProfiles = { ...existingProfiles, ...pack.profiles };
-    const mergedDomains = { ...existingDomains, ...(pack.domains ?? {}) };
     const profilesAdded = Object.keys(pack.profiles).length;
     const domainsAdded = Object.keys(pack.domains ?? {}).length;
     try {
-        await saveUserProfiles(mergedProfiles, mergedDomains);
+        await mutateProfiles((data) => {
+            Object.assign(data.profiles, pack.profiles);
+            Object.assign(data.domains, pack.domains ?? {});
+        });
     }
     catch (error) {
         errors.push("Failed to save profiles: " + ((error instanceof Error) ? error.message : String(error)));
@@ -120,16 +121,12 @@ export async function importProviderPack(pack, options = {}) {
     // profiles and domains were already saved successfully above.
     let channelsAdded = 0;
     if (!options.skipChannels && pack.channels && (Object.keys(pack.channels).length > 0)) {
+        const packChannels = pack.channels;
         try {
-            const result = await loadUserChannels();
-            if (result.parseError) {
-                errors.push("Cannot import channels: channels file contains invalid JSON.");
-            }
-            else {
-                const mergedChannels = { ...result.channels, ...pack.channels };
-                await saveUserChannels(mergedChannels);
-                channelsAdded = Object.keys(pack.channels).length;
-            }
+            await mutateChannels((channels) => {
+                Object.assign(channels, packChannels);
+            });
+            channelsAdded = Object.keys(packChannels).length;
         }
         catch (error) {
             errors.push("Failed to save channels: " + ((error instanceof Error) ? error.message : String(error)));
@@ -144,13 +141,13 @@ export async function importProviderPack(pack, options = {}) {
     };
 }
 /**
- * Exports one or more user profiles and their associated domain mappings as a provider pack JSON object. Optionally includes channels that reference the
+ * Exports one or more user profiles and their associated domain mappings as a service pack JSON object. Optionally includes channels that reference the
  * selected profiles.
  * @param profileKeys - Array of user profile keys to export.
  * @param options - Export options controlling what to include.
- * @returns The provider pack object, or null if none of the requested profiles exist.
+ * @returns The service pack object, or null if none of the requested profiles exist.
  */
-export function exportProviderPack(profileKeys, options = {}) {
+export function exportServicePack(profileKeys, options = {}) {
     const userProfiles = getUserProfiles();
     const matchedProfiles = {};
     for (const key of profileKeys) {
@@ -188,7 +185,7 @@ export function exportProviderPack(profileKeys, options = {}) {
         const channels = {};
         for (const entry of listing) {
             if (entry.channel.profile && keySet.has(entry.channel.profile)) {
-                // Strip hdhrEnabled from exported channels — it's a local deployment preference, not a provider configuration property.
+                // Strip hdhrEnabled from exported channels — it's a local deployment preference, not a service configuration property.
                 const exportChannel = { ...entry.channel };
                 Reflect.deleteProperty(exportChannel, "hdhrEnabled");
                 channels[entry.key] = exportChannel;
@@ -200,4 +197,4 @@ export function exportProviderPack(profileKeys, options = {}) {
     }
     return pack;
 }
-//# sourceMappingURL=providerPacks.js.map
+//# sourceMappingURL=servicePacks.js.map

package/dist/config/servicePacks.js.map

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

package/dist/config/services.d.ts

@@ -0,0 +1,202 @@
+import type { Channel, ChannelMap, ChannelSortField, ServiceGroup, SortDirection } from "../types/index.js";
+/**
+ * Gets the service tag for a channel key. For channels in a service group, reads the pre-computed tag from the group variant entry (computed at group-building
+ * time by buildServiceGroups). For standalone channels not in any group, derives the tag from the channel's URL domain. This function should not be called with
+ * :predefined synthetic keys — those only exist inside service groups and their tags are available via the group's variant entries.
+ * @param key - The channel key.
+ * @returns The service tag string.
+ */
+export declare function getServiceTagForChannel(key: string): string;
+/**
+ * Returns the auth domain for a channel key. Domain is the natural auth boundary — browser cookies and sessions scope to it. Multi-channel services work correctly
+ * because all their channels share one domain, and canonical channels work correctly because each has its own domain.
+ * @param key - The channel key.
+ * @returns The extracted domain from the channel's URL, or empty string if the channel or URL cannot be resolved.
+ */
+export declare function getAuthDomainForChannel(key: string): string;
+/**
+ * Returns all service tags for a channel (canonical tag + all variant suffix tags). Used to determine which services offer this channel.
+ * @param canonicalKey - The canonical channel key.
+ * @returns Array of service tag strings.
+ */
+export declare function getChannelServiceTags(canonicalKey: string): string[];
+/**
+ * Scans all service groups and collects unique service tags with display names. Display names are derived from the service field in DOMAIN_CONFIG entries that
+ * have a serviceTag.
+ * @returns Array of { displayName, domain, iconUrl, tag } objects sorted alphabetically by display name, with "direct" always first.
+ */
+export declare function getAllServiceTags(): {
+    displayName: string;
+    domain?: string;
+    iconUrl?: string;
+    tag: string;
+}[];
+/**
+ * Gets the current enabled service tags.
+ * @returns Copy of the enabled services array. Empty means no filter (all shown).
+ */
+export declare function getEnabledServices(): string[];
+/**
+ * Sets the enabled service tags. Empty array means "no filter" (all services shown).
+ * @param tags - The service tags to enable.
+ */
+export declare function setEnabledServices(tags: string[]): void;
+/**
+ * Checks if a service 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 service tag to check.
+ * @returns True if the service is available.
+ */
+export declare function isServiceTagEnabled(tag: string): boolean;
+/**
+ * Centralized availability check for the service filter. Returns true if the channel has at least one variant whose service tag is enabled.
+ * @param canonicalKey - The canonical channel key.
+ * @returns True if the channel passes the service filter.
+ */
+export declare function isChannelAvailableByService(canonicalKey: string): boolean;
+/**
+ * Builds service groups by scanning all channels and grouping by canonicalKey. Variant entries declare their canonical via the canonicalKey field (set by the
+ * flattener for predefined channels, by the browse modal for user channels, and by the one-time migration for pre-existing user entries). This is a single
+ * pass over the merged channel map — one field, one mechanism for both predefined and user-defined variant relationships.
+ *
+ * User overrides of predefined channels (same key, different object reference) produce a two-entry group with "Custom" and the original predefined version,
+ * even for single-service channels that don't have canonicalKey-based variants.
+ *
+ * After building groups, validates stored service selections against the new variant structure and reverts any stale selections to the canonical default. This
+ * catches all staleness sources in one place: service key renames across versions, variant removal in code, user-deleted custom variants, and reverted
+ * predefined overrides.
+ * @param channels - The merged channel map (predefined + user channels).
+ * @returns Canonical keys whose service selections were stale and reverted. Empty array if all selections are valid. The caller decides whether to persist.
+ */
+export declare function buildServiceGroups(channels: ChannelMap): string[];
+interface PredefinedChannelSummary {
+    canonicalKey: string;
+    name: string;
+    serviceCount: number;
+}
+/**
+ * Returns predefined channels whose canonical URL domain matches the given URL's domain. Used by the manual add form to show an inline hint when the user
+ * enters a URL that has predefined channels available. Returns an empty array when no predefined channels match.
+ * @param url - The URL to match against predefined channel domains.
+ * @returns Array of matching predefined channel summaries with canonical key, display name, and available service count.
+ */
+export declare function findPredefinedByDomain(url: string): PredefinedChannelSummary[];
+/**
+ * Returns the full domain-to-predefined-channel index for client-side embedding. Used by the channels panel to embed predefined match data so the manual add
+ * form can show inline hints without a server round-trip. The returned object is keyed by concise domain with arrays of channel summaries as values.
+ * @returns Record mapping domains to predefined channel summaries.
+ */
+export declare function getPredefinedDomainMap(): Record<string, PredefinedChannelSummary[]>;
+/**
+ * Resolves a URL to a friendly service display name. Checks built-in DOMAIN_CONFIG first for a stable, well-known service name, then falls back to
+ * getDomainConfig() which includes user domain mappings. This ordering prevents user domain overrides from corrupting display labels for predefined channel
+ * variants — a user mapping a built-in domain to a custom profile should not rename every service dropdown entry that uses that domain.
+ * @param url - The URL to resolve a service display name for.
+ * @returns The service display name, or the concise domain if no service name is configured.
+ */
+export declare function getServiceDisplayName(url: string): string;
+/**
+ * Resolves the service display label for a channel. Checks in order: explicit `service` field on the channel, the channel's explicit profile resolved via
+ * user domain mappings, then URL-based built-in display name. This ensures channels assigned to user-defined profiles show the profile's service name rather
+ * than the built-in name for the URL domain.
+ * @param channel - The channel to resolve a label for.
+ * @returns The service display label.
+ */
+export declare function getChannelServiceLabel(channel: Channel): string;
+export declare const VALID_SORT_FIELDS: Set<ChannelSortField>;
+/**
+ * Extracts a sortable string value from a channel for the specified sort field. Channel numbers are zero-padded to 6 digits for correct numeric ordering within a
+ * string comparison. Service values use the display label for human-meaningful sort order. This is the single source of truth for channel sort key extraction,
+ * shared by both the server-side table renderer and the M3U playlist generator.
+ * @param channel - Fallback channel definition, used only when the selected service variant cannot be resolved (e.g., key not in the merged channel map).
+ * @param key - The canonical channel key. Used for key-based sorting and to resolve the selected service variant internally.
+ * @param field - The sort field to extract.
+ * @returns A lowercase string suitable for comparison-based sorting.
+ */
+export declare function getChannelSortKey(channel: Channel, key: string, field: ChannelSortField): string;
+/**
+ * Compares two channels for sorting by the specified field and direction with a built-in channel name tiebreaker. The tiebreaker is always ascending so that rows
+ * within each group maintain a consistent alphabetical order regardless of the primary sort direction. This is the single comparator for all sort sites — server HTML
+ * render, client re-sort, and M3U playlist — to prevent ordering divergence.
+ * @param channelA - First channel definition.
+ * @param keyA - First channel key.
+ * @param channelB - Second channel definition.
+ * @param keyB - Second channel key.
+ * @param field - The sort field to compare.
+ * @param direction - Sort direction for the primary field.
+ * @returns A negative, zero, or positive number for sort ordering.
+ */
+export declare function compareChannelSort(channelA: Channel, keyA: string, channelB: Channel, keyB: string, field: ChannelSortField, direction: SortDirection): number;
+/**
+ * Gets the service group for a channel key. Works with both canonical and variant keys.
+ * @param key - Any channel key in the group.
+ * @returns The service group if the channel is part of a multi-service group, undefined otherwise.
+ */
+export declare function getServiceGroup(key: string): ServiceGroup | undefined;
+/**
+ * Checks if a channel key is a non-canonical service 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 service group.
+ */
+export declare function isServiceVariant(key: string): boolean;
+/**
+ * Checks if a channel has multiple service options. Used to determine whether to show a service dropdown in the UI.
+ * @param key - The channel key to check.
+ * @returns True if the channel has more than one service variant.
+ */
+export declare function hasMultipleServices(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 service group, or the input key if not part of a group.
+ */
+export declare function getCanonicalKey(key: string): string;
+/**
+ * Sets the user's service selections. Called when loading from channels.json.
+ * @param selections - Service selections keyed by canonical channel key.
+ */
+export declare function setServiceSelections(selections: Record<string, string>): void;
+/**
+ * Gets all service selections.
+ * @returns Copy of the service selections object.
+ */
+export declare function getServiceSelections(): Record<string, string>;
+/**
+ * Gets the service selection for a specific channel.
+ * @param canonicalKey - The canonical channel key.
+ * @returns The selected service key, or undefined if using the default.
+ */
+export declare function getServiceSelection(canonicalKey: string): string | undefined;
+/**
+ * Sets the service selection for a channel.
+ * @param canonicalKey - The canonical channel key.
+ * @param serviceKey - The selected service key.
+ */
+export declare function setServiceSelection(canonicalKey: string, serviceKey: string): void;
+/**
+ * Resolves a canonical channel key to the actual channel key based on user selection. If the user has selected a specific service for this channel, returns that
+ * service's key. Otherwise returns the canonical key (default service). When the service filter is active, falls back to the first enabled variant if the stored
+ * selection's service is filtered out.
+ *
+ * This function is a pure resolver with no side effects. Stale selection cleanup is handled by buildServiceGroups(), which validates all stored selections
+ * against the rebuilt variant structure every time groups are rebuilt - both at startup and after runtime channel mutations.
+ * @param canonicalKey - The canonical channel key.
+ * @returns The resolved service key to use for streaming.
+ */
+export declare function resolveServiceKey(canonicalKey: string): string;
+/**
+ * Gets a channel with inheritance applied. For service variants, this merges the variant's properties with inherited properties from the canonical entry
+ * using the live channel data (which includes user overrides). Use `resolvePredefinedVariant()` when you need resolution against pure predefined data.
+ * @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;
+/**
+ * Resolves a variant channel key against pure predefined data (ignoring user overrides). This is used for revert detection — when the user's edits match a
+ * variant's predefined definition, the custom override can be removed and the service selection switched to that variant. For canonical keys, returns the raw
+ * predefined channel. For variant keys, applies the same inheritance rules as `getResolvedChannel()` but against `PREDEFINED_CHANNELS` instead of `channelsRef`.
+ * @param key - The channel key (canonical or variant).
+ * @returns The channel with inheritance applied against predefined data, or undefined if the key has no predefined definition.
+ */
+export declare function resolvePredefinedVariant(key: string): Channel | undefined;
+export {};