prismcast 1.9.0 → 1.10.0

package/dist/routes/config/channels/endpoints/tags.js

@@ -0,0 +1,185 @@
+import { getActiveTagVocabulary, getPredefinedChannel, getTagRegistry, isInVocabulary, setTagRegistry, tagsMatch, transformChannelTags } from "../../../../config/userChannels.js";
+import { sendConflictError, sendError, sendNotFoundError, sendSuccess, sendValidationError } from "../../http/envelope.js";
+import { LOG } from "../../../../utils/index.js";
+import { PREDEFINED_TAGS } from "../../../../channels/index.js";
+import { route } from "../http/handler.js";
+// Pattern for valid tag names: must start and end with alphanumeric, may contain letters, numbers, spaces, and hyphens in between. Enforced on create and rename.
+const TAG_NAME_PATTERN = /^[a-zA-Z0-9]([a-zA-Z0-9 -]*[a-zA-Z0-9])?$/;
+// Maximum tag name length, enforced on create and rename.
+const TAG_NAME_MAX_LENGTH = 30;
+/**
+ * Validates a submitted tag name against the project's tag-name rules (required, length cap, character pattern). Returns an error message on failure or
+ * undefined when the name passes. Used by both the create and rename endpoints so the rules live in exactly one place.
+ * @param tag - The tag name to validate. Caller is expected to have already trimmed whitespace.
+ * @returns The user-facing validation error, or undefined when valid.
+ */
+function validateTagName(tag) {
+    if (tag.length === 0) {
+        return "Tag name is required.";
+    }
+    if (tag.length > TAG_NAME_MAX_LENGTH) {
+        return "Tag name must be " + String(TAG_NAME_MAX_LENGTH) + " characters or less.";
+    }
+    if (!TAG_NAME_PATTERN.test(tag)) {
+        return "Tag name must start and end with a letter or number, and contain only letters, numbers, spaces, and hyphens.";
+    }
+    return undefined;
+}
+/**
+ * Registers the tag management endpoints on the Express application.
+ * @param app - The Express application.
+ */
+export function registerTagRoutes(app) {
+    // GET /config/tags - Returns the tag vocabulary and registry state.
+    app.get("/config/tags", route("read tags", (_req, res) => {
+        res.json({
+            active: getActiveTagVocabulary(),
+            predefined: [...PREDEFINED_TAGS],
+            registry: getTagRegistry(),
+            success: true
+        });
+    }));
+    // POST /config/tags - Create a new user tag. Validates the tag name and rejects duplicates against the active vocabulary or deleted predefined tags (which
+    // should be restored, not re-created).
+    app.post("/config/tags", route("create tag", async (req, res) => {
+        const body = req.body;
+        const tag = typeof body.tag === "string" ? body.tag.trim() : "";
+        const nameError = validateTagName(tag);
+        if (nameError) {
+            sendValidationError(res, nameError);
+            return;
+        }
+        if (isInVocabulary(tag)) {
+            sendConflictError(res, "Tag '" + tag + "' already exists.");
+            return;
+        }
+        const registry = getTagRegistry();
+        if (registry.deletedTags.some((t) => tagsMatch(t, tag))) {
+            sendConflictError(res, "Tag '" + tag + "' is a deleted predefined tag. Use restore instead of creating a new one.");
+            return;
+        }
+        registry.tags.push(tag);
+        await setTagRegistry(registry);
+        LOG.info("Created tag: %s.", tag);
+        sendSuccess(res, { tags: true });
+    }));
+    // DELETE /config/tags/:tag - Delete a tag from the vocabulary and cascade to all channel assignments. For predefined tags, the tag is added to deletedTags. For
+    // user-created tags, the tag is removed from the user registry.
+    app.delete("/config/tags/:tag", route("delete tag", async (req, res) => {
+        const tag = req.params.tag?.trim() ?? "";
+        if (tag.length === 0) {
+            sendValidationError(res, "Tag name is required.");
+            return;
+        }
+        const registry = getTagRegistry();
+        const isPredefined = PREDEFINED_TAGS.some((t) => tagsMatch(t, tag));
+        const isUserTag = registry.tags.some((t) => tagsMatch(t, tag));
+        if (!isPredefined && !isUserTag) {
+            sendNotFoundError(res, "Tag '" + tag + "' not found.");
+            return;
+        }
+        if (isPredefined) {
+            const canonicalTag = PREDEFINED_TAGS.find((t) => tagsMatch(t, tag)) ?? tag;
+            // Already deleted - no-op, return current state without unnecessary I/O.
+            if (registry.deletedTags.some((t) => tagsMatch(t, tag))) {
+                sendSuccess(res, { tags: true });
+                return;
+            }
+            registry.deletedTags.push(canonicalTag);
+        }
+        else {
+            registry.tags = registry.tags.filter((t) => !tagsMatch(t, tag));
+        }
+        await setTagRegistry(registry);
+        // Cascade: strip the deleted tag from every channel that has it. transformChannelTags handles loading, delta normalization, and persistence.
+        const { affectedKeys, error } = await transformChannelTags((entry) => entry.channel.tags?.some((t) => tagsMatch(t, tag)) === true, (tags) => tags.filter((t) => !tagsMatch(t, tag)));
+        if (error) {
+            sendError(res, 400, { error });
+            return;
+        }
+        LOG.info("Deleted tag '%s' from vocabulary and %d channel assignments.", tag, affectedKeys.length);
+        sendSuccess(res, { affectedKeys, tags: true });
+    }));
+    // POST /config/tags/restore - Restore a previously deleted predefined tag. Removes it from deletedTags so it reappears in the active vocabulary, then cascade-
+    // restores the tag on predefined channels whose definition includes it.
+    app.post("/config/tags/restore", route("restore tag", async (req, res) => {
+        const body = req.body;
+        const tag = typeof body.tag === "string" ? body.tag.trim() : "";
+        if (tag.length === 0) {
+            sendValidationError(res, "Tag name is required.");
+            return;
+        }
+        const registry = getTagRegistry();
+        if (!registry.deletedTags.some((t) => tagsMatch(t, tag))) {
+            sendNotFoundError(res, "Tag '" + tag + "' is not a deleted predefined tag.");
+            return;
+        }
+        registry.deletedTags = registry.deletedTags.filter((t) => !tagsMatch(t, tag));
+        await setTagRegistry(registry);
+        // Resolve the canonical predefined tag name for the restored tag so channel data uses the predefined casing.
+        const canonicalTag = PREDEFINED_TAGS.find((t) => tagsMatch(t, tag)) ?? tag;
+        // Cascade-restore: add the tag back to predefined channels whose definition includes it but whose current resolved tags don't (stripped during cascade
+        // delete). The normalizer strips the tags delta when the result matches the predefined definition, reverting the channel to its default state.
+        const { affectedKeys, error } = await transformChannelTags((entry) => {
+            const predefined = getPredefinedChannel(entry.key);
+            return (predefined?.tags?.some((t) => tagsMatch(t, tag)) === true) &&
+                (entry.channel.tags?.some((t) => tagsMatch(t, tag)) !== true);
+        }, (tags) => [...tags, canonicalTag]);
+        if (error) {
+            sendError(res, 400, { error });
+            return;
+        }
+        LOG.info("Restored predefined tag '%s' on %d channels.", tag, affectedKeys.length);
+        sendSuccess(res, { affectedKeys, tags: true });
+    }));
+    // POST /config/tags/rename - Rename a tag atomically across the vocabulary and all channel assignments. Case-only renames are allowed (the identity is shared).
+    app.post("/config/tags/rename", route("rename tag", async (req, res) => {
+        const body = req.body;
+        const oldTag = typeof body.oldTag === "string" ? body.oldTag.trim() : "";
+        const newTag = typeof body.newTag === "string" ? body.newTag.trim() : "";
+        if (!oldTag || !newTag) {
+            sendValidationError(res, "Both old and new tag names are required.");
+            return;
+        }
+        if (oldTag === newTag) {
+            sendValidationError(res, "New tag name must differ from the old name.");
+            return;
+        }
+        const newTagError = validateTagName(newTag);
+        if (newTagError) {
+            sendValidationError(res, newTagError);
+            return;
+        }
+        if (!isInVocabulary(oldTag)) {
+            sendNotFoundError(res, "Tag '" + oldTag + "' not found.");
+            return;
+        }
+        // Collision check: allow case-only renames of the same identity, reject collisions with a different existing tag.
+        if (isInVocabulary(newTag) && !tagsMatch(oldTag, newTag)) {
+            sendConflictError(res, "Tag '" + newTag + "' already exists.");
+            return;
+        }
+        const registry = getTagRegistry();
+        const oldIsPredefined = PREDEFINED_TAGS.some((t) => tagsMatch(t, oldTag));
+        if (oldIsPredefined) {
+            // Predefined tag: "delete" the old (add to deletedTags using the canonical predefined form) and create the new as a user tag.
+            const canonicalOld = PREDEFINED_TAGS.find((t) => tagsMatch(t, oldTag)) ?? oldTag;
+            if (!registry.deletedTags.some((t) => tagsMatch(t, oldTag))) {
+                registry.deletedTags.push(canonicalOld);
+            }
+            registry.tags.push(newTag);
+        }
+        else {
+            registry.tags = registry.tags.map((t) => tagsMatch(t, oldTag) ? newTag : t);
+        }
+        await setTagRegistry(registry);
+        const { affectedKeys, error } = await transformChannelTags((entry) => entry.channel.tags?.some((t) => tagsMatch(t, oldTag)) === true, (tags) => tags.map((t) => tagsMatch(t, oldTag) ? newTag : t));
+        if (error) {
+            sendError(res, 400, { error });
+            return;
+        }
+        LOG.info("Renamed tag '%s' to '%s' across %d channels.", oldTag, newTag, affectedKeys.length);
+        sendSuccess(res, { affectedKeys, tags: true });
+    }));
+}
+//# sourceMappingURL=tags.js.map

package/dist/routes/config/channels/endpoints/tags.js.map

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

package/dist/routes/config/channels/http/handler.d.ts

@@ -0,0 +1,10 @@
+import type { Request, RequestHandler, Response } from "express";
+/**
+ * Wraps an endpoint handler with uniform error handling. The returned RequestHandler awaits the handler's (possibly sync) completion and catches any exception,
+ * routing it through sendErrorResponse using the provided action label. Accepting both sync and async handlers lets endpoints that don't need to await (e.g.,
+ * reads that respond immediately) skip the async keyword without a lint warning.
+ * @param action - Human-readable description of the action for log messages (e.g., "toggle channel", "save channel"). Appears in the error log and 500 response.
+ * @param handler - The endpoint implementation. Receives the Express request and response. Should early-return after calling sendValidationError/sendSuccess.
+ * @returns An Express RequestHandler suitable for registering with app.get/post/put/patch/delete.
+ */
+export declare function route(action: string, handler: (req: Request, res: Response) => Promise<void> | void): RequestHandler;

package/dist/routes/config/channels/http/handler.js

@@ -0,0 +1,20 @@
+import { sendErrorResponse } from "../../http/envelope.js";
+/**
+ * Wraps an endpoint handler with uniform error handling. The returned RequestHandler awaits the handler's (possibly sync) completion and catches any exception,
+ * routing it through sendErrorResponse using the provided action label. Accepting both sync and async handlers lets endpoints that don't need to await (e.g.,
+ * reads that respond immediately) skip the async keyword without a lint warning.
+ * @param action - Human-readable description of the action for log messages (e.g., "toggle channel", "save channel"). Appears in the error log and 500 response.
+ * @param handler - The endpoint implementation. Receives the Express request and response. Should early-return after calling sendValidationError/sendSuccess.
+ * @returns An Express RequestHandler suitable for registering with app.get/post/put/patch/delete.
+ */
+export function route(action, handler) {
+    return async (req, res) => {
+        try {
+            await handler(req, res);
+        }
+        catch (error) {
+            sendErrorResponse(res, error, action);
+        }
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/routes/config/channels/http/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../../../src/routes/config/channels/http/handler.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;;;;;GAOG;AACH,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,OAA8D;IAElG,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QAExB,IAAI,CAAC;YAEH,MAAM,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAM,KAAK,EAAE,CAAC;YAEd,iBAAiB,CAAC,GAAG,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/routes/config/channels/http/playlistHint.d.ts

@@ -0,0 +1,25 @@
+import type { ChannelDelta, ResolvedChannel, StoredChannel } from "../../../../types/index.ts";
+export declare const M3U_FIELDS: readonly ["channelNumber", "guideTitle", "logoUrl", "name", "stationId", "tvgShift"];
+export declare const PLAYLIST_HINT = " Reload the playlist in Channels DVR to see this change.";
+/**
+ * Returns PLAYLIST_HINT when a stored channel entry contains any M3U-affecting fields, otherwise an empty string. Used when reverting or removing an override to
+ * decide whether the response should include the reload hint.
+ * @param stored - The stored channel data (may be a delta or full definition).
+ * @returns The hint string, or an empty string when no M3U-affecting fields are present.
+ */
+export declare function playlistHintForStored(stored: StoredChannel | undefined): string;
+/**
+ * Returns PLAYLIST_HINT when a delta contains any M3U-affecting field changes, otherwise an empty string. Used after storing a delta override to decide whether
+ * the response should include the reload hint.
+ * @param delta - The channel delta that was stored.
+ * @returns The hint string, or an empty string when no M3U-affecting fields changed.
+ */
+export declare function playlistHintForDelta(delta: ChannelDelta): string;
+/**
+ * Returns PLAYLIST_HINT when any M3U-affecting field differs between two channel snapshots, otherwise an empty string. Used during an edit of a user channel
+ * (non-delta) where the entire channel record is rewritten - we compare before and after to decide whether the change is playlist-visible.
+ * @param previous - The channel record before the mutation, or undefined when adding a new channel.
+ * @param next - The channel record after the mutation.
+ * @returns The hint string, or an empty string when no M3U-affecting fields changed.
+ */
+export declare function playlistHintForChange(previous: ResolvedChannel | undefined, next: ResolvedChannel): string;

package/dist/routes/config/channels/http/playlistHint.js

@@ -0,0 +1,40 @@
+/* Fields that appear in the generated M3U playlist and affect Channels DVR's view of the channel. When any of these change, we append PLAYLIST_HINT so the
+ * user knows to reload the playlist in Channels DVR for the change to take effect. The `satisfies` constraint ensures every entry is a real ResolvedChannel
+ * property name, so renaming a Channel identity field flags this list at compile time instead of silently orphaning the check.
+ */
+export const M3U_FIELDS = ["channelNumber", "guideTitle", "logoUrl", "name", "stationId", "tvgShift"];
+// Appended to success messages when an M3U-affecting field changed. Begins with a leading space so callers can concatenate directly onto their message.
+export const PLAYLIST_HINT = " Reload the playlist in Channels DVR to see this change.";
+/**
+ * Returns PLAYLIST_HINT when a stored channel entry contains any M3U-affecting fields, otherwise an empty string. Used when reverting or removing an override to
+ * decide whether the response should include the reload hint.
+ * @param stored - The stored channel data (may be a delta or full definition).
+ * @returns The hint string, or an empty string when no M3U-affecting fields are present.
+ */
+export function playlistHintForStored(stored) {
+    return stored && M3U_FIELDS.some((f) => f in stored) ? PLAYLIST_HINT : "";
+}
+/**
+ * Returns PLAYLIST_HINT when a delta contains any M3U-affecting field changes, otherwise an empty string. Used after storing a delta override to decide whether
+ * the response should include the reload hint.
+ * @param delta - The channel delta that was stored.
+ * @returns The hint string, or an empty string when no M3U-affecting fields changed.
+ */
+export function playlistHintForDelta(delta) {
+    return M3U_FIELDS.some((f) => f in delta) ? PLAYLIST_HINT : "";
+}
+/**
+ * Returns PLAYLIST_HINT when any M3U-affecting field differs between two channel snapshots, otherwise an empty string. Used during an edit of a user channel
+ * (non-delta) where the entire channel record is rewritten - we compare before and after to decide whether the change is playlist-visible.
+ * @param previous - The channel record before the mutation, or undefined when adding a new channel.
+ * @param next - The channel record after the mutation.
+ * @returns The hint string, or an empty string when no M3U-affecting fields changed.
+ */
+export function playlistHintForChange(previous, next) {
+    // Adds always change the playlist - a new channel is inherently a new M3U entry.
+    if (!previous) {
+        return PLAYLIST_HINT;
+    }
+    return M3U_FIELDS.some((f) => previous[f] !== next[f]) ? PLAYLIST_HINT : "";
+}
+//# sourceMappingURL=playlistHint.js.map

package/dist/routes/config/channels/http/playlistHint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playlistHint.js","sourceRoot":"","sources":["../../../../../src/routes/config/channels/http/playlistHint.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAE,eAAe,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,CAAwD,CAAC;AAE9J,wJAAwJ;AACxJ,MAAM,CAAC,MAAM,aAAa,GAAG,0DAA0D,CAAC;AAExF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiC;IAErE,OAAO,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;AAC5E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IAEtD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAqC,EAAE,IAAqB;IAEhG,iFAAiF;IACjF,IAAG,CAAC,QAAQ,EAAE,CAAC;QAEb,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9E,CAAC"}

package/dist/routes/config/channels/http/serviceWarning.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Builds a service filter warning payload when a URL's service tag is not in the active filter. Returns undefined when no filter is active, the URL resolves to
+ * the "direct" (non-service) tag, or the tag is already enabled.
+ * @param url - The channel URL to derive the service tag from.
+ * @returns The warning with display label and tag, or undefined when no warning is needed.
+ */
+export declare function buildServiceFilterWarning(url: string): {
+    serviceLabel: string;
+    serviceTag: string;
+} | undefined;

package/dist/routes/config/channels/http/serviceWarning.js

@@ -0,0 +1,28 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * serviceWarning.ts: Shared helper for building the "service not in active filter" warning.
+ *
+ * When a user adds a channel whose service tag isn't in the active service filter, the channel would be hidden from the playlist and table immediately. The
+ * warning payload tells the client to show a toast with a one-click enable action. Both the browse endpoint (bulk add) and the CRUD endpoint (single add) use this
+ * helper so the warning policy is defined exactly once.
+ */
+import { getEnabledServices, getServiceDisplayName, isServiceTagEnabled } from "../../../../config/services.js";
+import { getDomainConfig } from "../../../../config/sites.js";
+/**
+ * Builds a service filter warning payload when a URL's service tag is not in the active filter. Returns undefined when no filter is active, the URL resolves to
+ * the "direct" (non-service) tag, or the tag is already enabled.
+ * @param url - The channel URL to derive the service tag from.
+ * @returns The warning with display label and tag, or undefined when no warning is needed.
+ */
+export function buildServiceFilterWarning(url) {
+    // No active filter means every service is visible - no warning needed.
+    if (getEnabledServices().length === 0) {
+        return undefined;
+    }
+    const tag = getDomainConfig(url)?.serviceTag;
+    if (tag && (tag !== "direct") && !isServiceTagEnabled(tag)) {
+        return { serviceLabel: getServiceDisplayName(url), serviceTag: tag };
+    }
+    return undefined;
+}
+//# sourceMappingURL=serviceWarning.js.map

package/dist/routes/config/channels/http/serviceWarning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceWarning.js","sourceRoot":"","sources":["../../../../../src/routes/config/channels/http/serviceWarning.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAChH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,GAAW;IAEnD,uEAAuE;IACvE,IAAG,kBAAkB,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAErC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,UAAU,CAAC;IAE7C,IAAG,GAAG,IAAI,CAAC,GAAG,KAAK,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;QAE1D,OAAO,EAAE,YAAY,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC;IACvE,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/routes/config/channels/index.d.ts

@@ -1,3 +1,3 @@
-export type { ChannelRowHtml, ChannelTableCounts, ChannelTablePatch } from "./table.js";
-export { OPTIONAL_COLUMNS, VALID_OPTIONAL_COLUMNS, buildChannelTablePatch, buildChannelTableState, generateChannelRowHtml, generateChannelsPanel, generateServiceFilterToolbar, generateTagFilterContent, generateTagManagerBody } from "./table.js";
-export { setupChannelRoutes } from "./routes.js";
+export type { ChannelRowHtml, ChannelTableCounts, ChannelTablePatch } from "./table.ts";
+export { OPTIONAL_COLUMNS, VALID_OPTIONAL_COLUMNS, buildChannelTablePatch, buildChannelTableState, generateChannelRowHtml, generateChannelsPanel, generateServiceFilterToolbar, generateTagFilterContent, generateTagManagerBody } from "./table.ts";
+export { setupChannelRoutes } from "./setup.ts";

package/dist/routes/config/channels/index.js

@@ -1,3 +1,3 @@
 export { OPTIONAL_COLUMNS, VALID_OPTIONAL_COLUMNS, buildChannelTablePatch, buildChannelTableState, generateChannelRowHtml, generateChannelsPanel, generateServiceFilterToolbar, generateTagFilterContent, generateTagManagerBody } from "./table.js";
-export { setupChannelRoutes } from "./routes.js";
+export { setupChannelRoutes } from "./setup.js";
 //# sourceMappingURL=index.js.map

package/dist/routes/config/channels/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/routes/config/channels/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAC9I,4BAA4B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/routes/config/channels/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,qBAAqB,EAC9I,4BAA4B,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AACrG,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC"}

package/dist/routes/config/channels/{routes.d.ts → setup.d.ts}

@@ -1,6 +1,6 @@
 import type { Express } from "express";
 /**
- * Installs all channel-related route handlers on the Express application.
+ * Installs all channel-configuration route handlers on the Express application.
  * @param app - The Express application.
  */
 export declare function setupChannelRoutes(app: Express): void;

package/dist/routes/config/channels/setup.js

@@ -0,0 +1,23 @@
+import { registerBrowseRoutes } from "./endpoints/browse.js";
+import { registerBulkRoutes } from "./endpoints/bulk.js";
+import { registerCrudRoutes } from "./endpoints/crud.js";
+import { registerImportExportRoutes } from "./endpoints/importExport.js";
+import { registerPredefinedRoutes } from "./endpoints/predefined.js";
+import { registerPrefsRoutes } from "./endpoints/prefs.js";
+import { registerServiceRoutes } from "./endpoints/service.js";
+import { registerTagRoutes } from "./endpoints/tags.js";
+/**
+ * Installs all channel-configuration route handlers on the Express application.
+ * @param app - The Express application.
+ */
+export function setupChannelRoutes(app) {
+    registerBrowseRoutes(app);
+    registerBulkRoutes(app);
+    registerCrudRoutes(app);
+    registerImportExportRoutes(app);
+    registerPredefinedRoutes(app);
+    registerPrefsRoutes(app);
+    registerServiceRoutes(app);
+    registerTagRoutes(app);
+}
+//# sourceMappingURL=setup.js.map

package/dist/routes/config/channels/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../../src/routes/config/channels/setup.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAE7C,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAC1B,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxB,0BAA0B,CAAC,GAAG,CAAC,CAAC;IAChC,wBAAwB,CAAC,GAAG,CAAC,CAAC;IAC9B,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACzB,qBAAqB,CAAC,GAAG,CAAC,CAAC;IAC3B,iBAAiB,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/routes/config/channels/table.d.ts

@@ -1,5 +1,5 @@
-import type { ChannelListingEntry } from "../../../types/index.js";
-import type { ProfileInfo } from "../../../config/profiles.js";
+import type { ChannelListingEntry } from "../../../types/index.ts";
+import type { ProfileInfo } from "../../../config/profiles.ts";
 export declare const OPTIONAL_COLUMNS: readonly {
     readonly align: string;
     readonly cssClass: string;
@@ -9,14 +9,14 @@ export declare const OPTIONAL_COLUMNS: readonly {
 }[];
 export declare const VALID_OPTIONAL_COLUMNS: Set<string>;
 /**
- * Generates the tag column filter dropdown content. This is the single source of truth for the filter checkbox list — used for both the initial header render
+ * Generates the tag column filter dropdown content. This is the single source of truth for the filter checkbox list - used for both the initial header render
  * and for incremental updates after tag CRUD operations. The dropdown shell (button, dropdown-menu wrapper) is rendered by the header generator; this function
  * provides only the inner content (checkbox labels + "Show All" item).
  * @returns HTML string for the filter dropdown content.
  */
 export declare function generateTagFilterContent(): string;
 /**
- * Generates the Tag Management modal body HTML. This is the single source of truth for tag manager content — used for both the initial server render and for
+ * Generates the Tag Management modal body HTML. This is the single source of truth for tag manager content - used for both the initial server render and for
  * incremental updates after tag CRUD operations. The endpoints return this HTML in the response so the client can replace the modal content without a page reload.
  * @returns HTML string for the tag manager body (tag list, input field, deleted tags section).
  */
@@ -29,7 +29,7 @@ export interface ChannelRowHtml {
     editRow: string;
 }
 /**
- * Generates the HTML for a single channel's table rows (display row and edit form row). All channels — predefined, override, and user-defined — get both rows.
+ * Generates the HTML for a single channel's table rows (display row and edit form row). All channels - predefined, override, and user-defined - get both rows.
  * The edit form is pre-populated with the effective (resolved) values so users see what they're changing. When called from generateChannelsPanel() which already
  * has the listing entry, pass it via the entry parameter to avoid redundant getChannelListing() calls. POST handlers that generate a single row omit the
  * parameter to trigger an internal lookup.
@@ -38,10 +38,10 @@ export interface ChannelRowHtml {
  * @param entry - Optional pre-resolved listing entry. When omitted, looked up from getChannelListing().
  * @returns Object with displayRow and editRow HTML strings.
  */
-export declare function generateChannelRowHtml(key: string, profiles: ProfileInfo[], entry?: ChannelListingEntry): ChannelRowHtml;
+export declare function generateChannelRowHtml(key: string, profiles: readonly ProfileInfo[], entry?: ChannelListingEntry): ChannelRowHtml;
 /**
  * Channel table state snapshot. Represents the complete set of summary counts for the channel header and scope toggles. Computed server-side as the single
- * source of truth — the client applies these values directly to DOM elements without recalculation.
+ * source of truth - the client applies these values directly to DOM elements without recalculation.
  */
 export interface ChannelTableCounts {
     disabled: number;
@@ -87,7 +87,7 @@ export interface ChannelTablePatch {
     }>;
 }
 /**
- * Computes the complete channel table state — summary counts and scope toggle counts — from the current channel listing. This is the server-side single source
+ * Computes the complete channel table state - summary counts and scope toggle counts - from the current channel listing. This is the server-side single source
  * of truth for all count computation, replacing the client-side DOM-scanning approach. Called once per mutation as part of building a patch.
  * @param listing - Optional pre-fetched listing. When omitted, fetches from getChannelListing(). Passing the listing avoids a redundant computation when
  *   buildChannelTablePatch already has it.
@@ -118,7 +118,7 @@ export declare function buildChannelTableState(listing?: ChannelListingEntry[]):
  * @param profiles - Available profiles for the edit form dropdown.
  * @returns A complete ChannelTablePatch ready for client-side application.
  */
-export declare function buildChannelTablePatch(affectedKeys: string[], profiles: ProfileInfo[]): ChannelTablePatch;
+export declare function buildChannelTablePatch(affectedKeys: readonly string[], profiles: readonly ProfileInfo[]): ChannelTablePatch;
 /**
  * Generates the service filter toolbar HTML with a multi-select dropdown and dismissable chips.
  * @returns HTML string for the service filter toolbar.