prismcast 1.10.2 → 1.11.0

package/dist/hdhr/discover.js

@@ -1,10 +1,11 @@
-import { getPackageVersion, normalizeClientAddress } from "../utils/index.js";
+import { HDHR_FIRMWARE_NAME, HDHR_MANUFACTURER, HDHR_MODEL_NUMBER } from "./identity.js";
+import { escapeXml, getPackageVersion } from "../utils/index.js";
 import { CONFIG } from "../config/index.js";
 import { buildChannelMap } from "./channelMap.js";
-import { getAllStreams } from "../streaming/registry.js";
+import { getTunerStates } from "./tunerState.js";
 /**
- * Resolves the hostname from an incoming request for use in generated URLs. We extract the hostname from the request (which Plex already connected to) and
- * combine it with the appropriate port. This ensures URLs work from Plex's network perspective.
+ * Resolves the hostname from an incoming request for use in generated URLs. We extract the hostname from the request (which the client already connected
+ * to) and combine it with the appropriate port. This ensures URLs work from the client's network perspective.
  * @param req - The Express request object.
  * @returns The hostname (without port) that the client used to connect.
  */
@@ -30,12 +31,18 @@ function resolveHostname(req) {
  * @param app - The Express application for the HDHR server.
  */
 export function setupHdhrEndpoints(app) {
-    // GET /device.xml - UPnP device description. Plex fetches this during tuner discovery before querying discover.json. Without a valid device.xml response,
-    // Plex may silently abort the discovery process.
+    // GET /device.xml - UPnP device description. HDHR-aware clients (Plex in particular) fetch this during tuner discovery before querying discover.json.
+    // Without a valid device.xml response the discovery process may abort silently on stricter clients.
     app.get("/device.xml", (req, res) => {
         const hostname = resolveHostname(req);
         const baseUrl = "http://" + hostname + ":" + String(CONFIG.hdhr.port);
         const deviceId = CONFIG.hdhr.deviceId.toUpperCase();
+        /* Every value interpolated below is escaped, the compile-time constants included, which is the convention the launchd plist generator follows: escaping at
+         * each interpolation point rather than trusting the shape of any particular value. The values outside our control are the ones somebody else supplies:
+         * friendlyName is free text the operator types, and baseUrl derives from the client-supplied Host or X-Forwarded-Host header that resolveHostname reads
+         * without sanitizing, so an unescaped ampersand or angle bracket from either source yields a document a client cannot parse. Escaping the constants costs
+         * nothing and means changing one of them can never reintroduce that.
+         */
         const xml = [
             "<?xml version=\"1.0\" encoding=\"UTF-8\"?>",
             "<root xmlns=\"urn:schemas-upnp-org:device-1-0\">",
@@ -43,43 +50,43 @@ export function setupHdhrEndpoints(app) {
             "    <major>1</major>",
             "    <minor>0</minor>",
             "  </specVersion>",
-            "  <URLBase>" + baseUrl + "</URLBase>",
+            "  <URLBase>" + escapeXml(baseUrl) + "</URLBase>",
             "  <device>",
             "    <deviceType>urn:schemas-upnp-org:device:MediaServer:1</deviceType>",
-            "    <friendlyName>" + CONFIG.hdhr.friendlyName + "</friendlyName>",
-            "    <manufacturer>PrismCast</manufacturer>",
-            "    <modelName>HDTC-2US</modelName>",
-            "    <modelNumber>HDTC-2US</modelNumber>",
-            "    <serialNumber>" + deviceId + "</serialNumber>",
-            "    <UDN>uuid:" + deviceId + "</UDN>",
+            "    <friendlyName>" + escapeXml(CONFIG.hdhr.friendlyName) + "</friendlyName>",
+            "    <manufacturer>" + escapeXml(HDHR_MANUFACTURER) + "</manufacturer>",
+            "    <modelName>" + escapeXml(HDHR_MODEL_NUMBER) + "</modelName>",
+            "    <modelNumber>" + escapeXml(HDHR_MODEL_NUMBER) + "</modelNumber>",
+            "    <serialNumber>" + escapeXml(deviceId) + "</serialNumber>",
+            "    <UDN>uuid:" + escapeXml(deviceId) + "</UDN>",
             "  </device>",
             "</root>"
         ].join("\n");
         res.set("Content-Type", "text/xml");
         res.send(xml);
     });
-    // GET /discover.json - Device identity and capabilities. Plex uses this to identify the tuner model, determine concurrent stream capacity, and locate the
+    // GET /discover.json - Device identity and capabilities. Clients use this to identify the tuner model, determine concurrent stream capacity, and locate the
     // lineup endpoint.
     app.get("/discover.json", (req, res) => {
         const hostname = resolveHostname(req);
         const baseUrl = "http://" + hostname + ":" + String(CONFIG.hdhr.port);
-        // The response follows the HDHomeRun HTTP API format that Plex expects. DeviceAuth must be non-empty; we use the DeviceID since there's no DRM context.
-        // ModelNumber "HDTC-2US" is the HDHomeRun CONNECT DUO, a widely-supported model that Plex recognizes.
+        // The response follows the HDHomeRun HTTP API format that Plex expects. DeviceAuth must be non-empty; we use the DeviceID since there is no DRM context.
+        // Identity strings come from hdhr/identity.ts so a future model swap is a single-file edit.
         res.json({
             BaseURL: baseUrl,
             DeviceAuth: CONFIG.hdhr.deviceId.toUpperCase(),
             DeviceID: CONFIG.hdhr.deviceId.toUpperCase(),
-            FirmwareName: "hdhomeruntc_atsc",
+            FirmwareName: HDHR_FIRMWARE_NAME,
             FirmwareVersion: getPackageVersion(),
             FriendlyName: CONFIG.hdhr.friendlyName,
             LineupURL: baseUrl + "/lineup.json",
-            Manufacturer: "PrismCast",
-            ModelNumber: "HDTC-2US",
+            Manufacturer: HDHR_MANUFACTURER,
+            ModelNumber: HDHR_MODEL_NUMBER,
             TunerCount: CONFIG.streaming.maxConcurrentStreams
         });
     });
-    // GET /lineup.json - Channel lineup with stream URLs. Each entry maps a numeric channel number to an MPEG-TS stream URL on the main PrismCast server. Plex
-    // requests the MPEG-TS stream directly from the main server when tuning a channel.
+    // GET /lineup.json - Channel lineup with stream URLs. Each entry maps a numeric channel number to an MPEG-TS stream URL on the main PrismCast server. The
+    // client requests the MPEG-TS stream directly from the main server when tuning a channel.
     app.get("/lineup.json", (req, res) => {
         const hostname = resolveHostname(req);
         const mainBaseUrl = "http://" + hostname + ":" + String(CONFIG.server.port);
@@ -94,7 +101,7 @@ export function setupHdhrEndpoints(app) {
         }));
         res.json(lineup);
     });
-    // GET /lineup_status.json - Channel scan status. Plex checks this during tuner setup. We return a static response indicating scan is complete since PrismCast's
+    // GET /lineup_status.json - Channel scan status. Clients check this during tuner setup. We return a static response indicating scan is complete since PrismCast's
     // channels are configured, not scanned.
     app.get("/lineup_status.json", (_req, res) => {
         res.json({
@@ -104,41 +111,35 @@ export function setupHdhrEndpoints(app) {
             SourceList: ["Cable"]
         });
     });
-    // POST /lineup.post - Channel scan control. Some clients (Plex during initial setup) POST scan=start to this endpoint. We return 200 OK since PrismCast's channels
-    // are statically configured and scanning is not applicable.
+    // POST /lineup.post - Channel scan control. Some clients (Plex during initial setup is the common case) POST scan=start here. We return 200 OK since
+    // PrismCast's channels are statically configured and scanning is not applicable.
     app.post("/lineup.post", (_req, res) => {
         res.sendStatus(200);
     });
     // GET /status.json - Tuner status. Returns a JSON array with one entry per tuner slot. Active tuners include channel info and signal stats; idle tuners have only
-    // Resource. Monitoring dashboards (Home Assistant, Homepage) poll this endpoint to display real-time tuner activity.
+    // Resource. Monitoring dashboards (Home Assistant, Homepage) poll this endpoint to display real-time tuner activity. The slot-indexed projection comes from
+    // getTunerStates - the same SSOT the UDP Get handlers use - so any change to channel-merge or fallback logic lands in one place.
     app.get("/status.json", (_req, res) => {
-        const channelMap = buildChannelMap();
-        const channelByKey = new Map(channelMap.map((entry) => [entry.key, entry]));
-        const streams = getAllStreams().sort((a, b) => a.id - b.id);
-        const tunerCount = CONFIG.streaming.maxConcurrentStreams;
-        const tuners = [];
-        // Build active tuner entries from currently running streams.
-        for (const [i, stream] of streams.entries()) {
-            const channelEntry = channelByKey.get(stream.info.storeKey);
-            // Build the tuner entry. Active tuners include channel info and signal stats. Signal values are hardcoded at 100 since PrismCast streams are network-based and
-            // either working or not - there is no analog signal quality to report. Channel info is merged conditionally: prefer the channel map for VctNumber (numeric
-            // channel) and VctName (display name), fall back to stream.channelName for VctName if the channel was removed from the map after the stream started.
-            const tuner = {
+        const tuners = getTunerStates().map((state) => {
+            // Idle slots carry only the resource name; active slots include signal stats hardcoded at 100 (network streams have no analog signal quality), plus
+            // channel and client information whenever the underlying TunerState provides it.
+            if (!state.active) {
+                return { Resource: state.resource };
+            }
+            return {
                 Frequency: 0,
-                Resource: "tuner" + String(i),
+                Resource: state.resource,
                 SignalQualityPercent: 100,
                 SignalStrengthPercent: 100,
                 SymbolQualityPercent: 100,
-                ...(channelEntry ? { VctName: channelEntry.name, VctNumber: String(channelEntry.number) } : {}),
-                ...(!channelEntry && stream.channelName ? { VctName: stream.channelName } : {}),
-                ...(stream.clientAddress ? { TargetIP: normalizeClientAddress(stream.clientAddress) } : {})
+                // The channelNumber guard checks (!== null) rather than truthiness because null is the only absent-sentinel this field carries; buildChannelMap never
+                // actually assigns a channelNumber of 0 today, but the explicit null check does not depend on that staying true. Name and address gate on truthiness
+                // instead because their absent case is naturally an empty string, so a truthy check is the right match for those two fields.
+                ...((state.channelNumber !== null) ? { VctNumber: String(state.channelNumber) } : {}),
+                ...(state.channelName ? { VctName: state.channelName } : {}),
+                ...(state.clientAddress ? { TargetIP: state.clientAddress } : {})
             };
-            tuners.push(tuner);
-        }
-        // Fill remaining slots with idle tuner entries.
-        for (let i = streams.length; i < tunerCount; i++) {
-            tuners.push({ Resource: "tuner" + String(i) });
-        }
+        });
         res.json(tuners);
     });
 }

package/dist/hdhr/discover.js.map

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

package/dist/hdhr/getHandlers.d.ts

@@ -0,0 +1,29 @@
+import type { TunerState } from "./tunerState.ts";
+/**
+ * Result of resolving a Get key. The discriminated union mirrors the protocol's reply shape: a value reply carries the answered string; an error reply carries
+ * the rejection reason. Callers translate the result into a wire packet via buildGetReply/buildErrorReply.
+ */
+export type GetResult = {
+    readonly kind: "value";
+    readonly value: string;
+} | {
+    readonly kind: "error";
+    readonly error: string;
+};
+/**
+ * Context required to answer a Get request. Carries the slot-indexed tuner state (so per-tuner keys can look up the addressed slot) and a runtime-version
+ * string (so /sys/version reflects the running build). Other identity-shaped values come from hdhr/identity.ts and do not need to flow through the context.
+ */
+export interface GetContext {
+    readonly runtimeVersion: string;
+    readonly tuners: readonly TunerState[];
+}
+/**
+ * Resolves a Get key to a reply value or an error. Single entry point the transport layer calls per request. Unknown keys produce an error result matching the
+ * "ERROR: unknown getset variable" prose real HDHR firmware uses.
+ * @param name - The slash-delimited Get key from the request.
+ * @param ctx - The resolution context (tuner state + runtime version).
+ * @returns The resolved value or an error.
+ */
+export declare function resolveGet(name: string, ctx: GetContext): GetResult;
+//# sourceMappingURL=getHandlers.d.ts.map

package/dist/hdhr/getHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getHandlers.d.ts","sourceRoot":"","sources":["../../src/hdhr/getHandlers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAOlD;;;GAGG;AACH,MAAM,MAAM,SAAS,GACnB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,UAAU;IAGzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAGhC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAC;CACxC;AA4BD;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,SAAS,CAqBnE"}

package/dist/hdhr/getHandlers.js

@@ -0,0 +1,196 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * getHandlers.ts: Data-driven dispatch table for HDHomeRun UDP Get requests.
+ *
+ * HDHR-aware clients can issue UDP Get requests for a small fixed catalog of named state keys ("/sys/version", "/tuner0/channel", ...) once they have located a
+ * device via Discover. The transport layer parses each request and routes it through this module's resolveGet function; the resolver consults a table of
+ * static-system keys (those whose value is a constant sourced from hdhr/identity.ts, a fixed literal, or the runtime-version carried on GetContext) and a
+ * regex for per-tuner keys (those whose value depends on which slot is being addressed). Unknown keys fall through to an error reply, matching real HDHR
+ * firmware behavior.
+ *
+ * Two layering choices keep this module easy to extend and test:
+ *
+ *   1. Pure functions over a GetContext boundary. Tests construct a synthetic context with any tuner state and assert reply values without touching CONFIG, the
+ *      stream registry, or any other global. The transport layer composes the production context once per request and passes it through.
+ *
+ *   2. A Record-keyed dispatch table for /sys/* keys, plus a single regex for /tuner<N>/*. Adding a new system key is a single row; adding a new per-tuner key
+ *      is one additional case in resolveTunerKey. The dispatch shape stays declarative even as the catalog grows.
+ */
+import { HDHR_COPYRIGHT, HDHR_HW_MODEL, HDHR_MODEL } from "./identity.js";
+// Canonical wire-protocol error string for fall-through cases (unknown system key, unknown per-tuner sub-key). Real HDHomeRun firmware uses this exact wording;
+// mirroring it keeps client error displays familiar to operators who have seen it from real devices. Hoisted to a module constant so both fall-through sites
+// agree on the spelling - any future tweak (capitalization, punctuation) lands in one place.
+const ERROR_UNKNOWN_GETSET = "ERROR: unknown getset variable";
+/**
+ * Dispatch table for /sys/* keys. Each entry is a single-argument function over GetContext returning the answer string. The table is the SSOT for which system
+ * keys PrismCast answers; adding a new key is a single row, and the parser, error path, and test surface require no other changes.
+ */
+const SYSTEM_HANDLERS = {
+    // Copyright string returned when probes call /sys/copyright. Static across runtime; sourced from the identity SSOT.
+    "/sys/copyright": () => HDHR_COPYRIGHT,
+    // Debug surface placeholder. Real HDHRs return verbose multi-line debug strings here; PrismCast returns an empty value so probes succeed without leaking
+    // internal state. Operators that want richer debug should consult the standard PrismCast logs instead.
+    "/sys/debug": () => "",
+    // Hardware model identifier. Constant across runtime; sourced from the identity SSOT.
+    "/sys/hwmodel": () => HDHR_HW_MODEL,
+    // Software model identifier (same as hardware model on the HDTC-2US family).
+    "/sys/model": () => HDHR_MODEL,
+    // Running version string, derived from package.json via the runtime context.
+    "/sys/version": (ctx) => ctx.runtimeVersion
+};
+// Regex matching per-tuner keys: "/tuner<N>/<sub-key>". Numeric capture group lets resolveTunerKey index into ctx.tuners; the second capture is the sub-key.
+const TUNER_KEY_PATTERN = /^\/tuner(\d+)\/(.+)$/;
+/**
+ * Resolves a Get key to a reply value or an error. Single entry point the transport layer calls per request. Unknown keys produce an error result matching the
+ * "ERROR: unknown getset variable" prose real HDHR firmware uses.
+ * @param name - The slash-delimited Get key from the request.
+ * @param ctx - The resolution context (tuner state + runtime version).
+ * @returns The resolved value or an error.
+ */
+export function resolveGet(name, ctx) {
+    // System keys go through the dispatch table first because they cover the most common probes (version, model, copyright).
+    const systemHandler = SYSTEM_HANDLERS[name];
+    if (systemHandler !== undefined) {
+        return { kind: "value", value: systemHandler(ctx) };
+    }
+    // Per-tuner keys go through the regex extractor. A match means "/tunerN/..." but the slot index may still be out of bounds for the configured tuner count;
+    // resolveTunerKey enforces both that bound and the sub-key catalog.
+    const tunerMatch = TUNER_KEY_PATTERN.exec(name);
+    if (tunerMatch !== null) {
+        return resolveTunerKey(Number(tunerMatch[1]), tunerMatch[2] ?? "", ctx);
+    }
+    // Fall through to the canonical "unknown getset variable" error so unknown system keys produce the same wording real HDHR firmware would.
+    return { error: ERROR_UNKNOWN_GETSET, kind: "error" };
+}
+/**
+ * Resolves a per-tuner Get key for a specific slot. Sub-keys fall into two families: static state returning constants that do not depend on the tuner's
+ * current activity, and dynamic state read from the addressed TunerState. Unknown sub-keys produce an error matching real HDHR behavior.
+ * @param slot - Zero-based tuner slot index.
+ * @param subKey - The sub-key portion after the slot prefix.
+ * @param ctx - The resolution context.
+ * @returns The resolved value or an error.
+ */
+function resolveTunerKey(slot, subKey, ctx) {
+    const state = ctx.tuners[slot] ?? null;
+    if (state === null) {
+        // Slot index out of range produces its own distinct error string, separate from the ERROR_UNKNOWN_GETSET fallback used for unrecognized sub-keys.
+        return { error: "ERROR: unknown tuner", kind: "error" };
+    }
+    switch (subKey) {
+        case "channel": {
+            return { kind: "value", value: formatChannel(state) };
+        }
+        case "channelmap": {
+            // Real HDHRs return the tuning band ("us-bcast", "us-cable"). PrismCast has no RF input, so we return an empty string - clients that filter on this
+            // value will route us to the generic IP-tuner code path.
+            return { kind: "value", value: "" };
+        }
+        case "debug": {
+            // Per-tuner debug placeholder, mirroring /sys/debug: PrismCast returns an empty value rather than the verbose per-tuner debug string real HDHRs emit.
+            return { kind: "value", value: "" };
+        }
+        case "filter": {
+            // PID filter. Default value matches a fully-open filter (every PID accepted), which is the right wire value for a tuner that has no PSI multiplexing.
+            return { kind: "value", value: "0x0000-0x1FFF" };
+        }
+        case "lockkey": {
+            // Lockkey is a write-once exclusive-tuner lock real HDHRs use. PrismCast has no exclusivity model, so we report it as unlocked.
+            return { kind: "value", value: "none" };
+        }
+        case "program": {
+            // MPEG-TS program number. We do not surface a useful value because PrismCast remuxes into a single-program MPEG-TS; clients that need it can read the
+            // stream itself.
+            return { kind: "value", value: "0" };
+        }
+        case "status": {
+            return { kind: "value", value: formatStatus(state) };
+        }
+        case "streaminfo": {
+            return { kind: "value", value: formatStreamInfo(state) };
+        }
+        case "target": {
+            return { kind: "value", value: formatTarget() };
+        }
+        case "vchannel": {
+            return { kind: "value", value: formatVchannel(state) };
+        }
+        case "vstatus": {
+            return { kind: "value", value: formatVstatus(state) };
+        }
+        default: {
+            return { error: ERROR_UNKNOWN_GETSET, kind: "error" };
+        }
+    }
+}
+/**
+ * Formats /tuner&lt;N&gt;/channel: the currently-tuned channel in HDHR notation. Active slots produce "auto:&lt;number&gt;" matching the HTTP-streaming convention; idle
+ * slots produce "none" as real HDHRs do.
+ * @param state - The slot's state.
+ * @returns The wire-formatted channel string.
+ */
+function formatChannel(state) {
+    if (!state.active || (state.channelNumber === null)) {
+        return "none";
+    }
+    return "auto:" + String(state.channelNumber);
+}
+/**
+ * Formats /tuner&lt;N&gt;/status: a single-line status string. Real HDHRs report something like "ch=auto:5 lock=8vsb ...". PrismCast has no analog tuning, so the
+ * relevant fields are channel binding and stream state.
+ * @param state - The slot's state.
+ * @returns The wire-formatted status string.
+ */
+function formatStatus(state) {
+    if (!state.active) {
+        return "ch=none lock=none ss=0 snq=0 seq=0 bps=0 pps=0";
+    }
+    // We report 100% on the signal metrics because the IP path either delivers bytes or it does not - there is no analog gradation. Bitrate is left at zero
+    // because we do not track it at this layer; clients that care can read /stream/* directly.
+    return "ch=" + formatChannel(state) + " lock=8vsb ss=100 snq=100 seq=100 bps=0 pps=0";
+}
+/**
+ * Formats /tuner&lt;N&gt;/streaminfo: a brief description of the program PrismCast is delivering. We surface the channel name when available so probe tools have a
+ * human-readable identifier.
+ * @param state - The slot's state.
+ * @returns The wire-formatted streaminfo string.
+ */
+function formatStreamInfo(state) {
+    if (!state.active || !state.channelName) {
+        return "none";
+    }
+    return state.channelName;
+}
+/**
+ * Formats /tuner&lt;N&gt;/target: the destination URL of any RTP forwarding the tuner is doing. PrismCast does not forward (clients fetch over HTTP), so the value
+ * is always "none" regardless of slot state. Real HDHRs use this key on legacy RTP-streaming devices; HTTP-streaming devices like the HDTC-2US that PrismCast
+ * emulates also return "none" here.
+ * @returns The wire-formatted target string.
+ */
+function formatTarget() {
+    return "none";
+}
+/**
+ * Formats /tuner&lt;N&gt;/vchannel: the virtual channel number (display number) the tuner is bound to. Real HDHRs differ between physical and virtual channels for
+ * over-the-air ATSC; PrismCast has only virtual numbers from the lineup.
+ * @param state - The slot's state.
+ * @returns The wire-formatted vchannel string.
+ */
+function formatVchannel(state) {
+    if (!state.active || (state.channelNumber === null)) {
+        return "none";
+    }
+    return String(state.channelNumber);
+}
+/**
+ * Formats /tuner&lt;N&gt;/vstatus: a parallel of /tuner&lt;N&gt;/status but reporting the virtual-channel lock state. We mirror /status because PrismCast has only the
+ * one channel concept.
+ * @param state - The slot's state.
+ * @returns The wire-formatted vstatus string.
+ */
+function formatVstatus(state) {
+    if (!state.active) {
+        return "vch=none auth=unknown cci=none cgms=none";
+    }
+    return "vch=" + formatVchannel(state) + " auth=success cci=none cgms=none";
+}
+//# sourceMappingURL=getHandlers.js.map

package/dist/hdhr/getHandlers.js.map

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

package/dist/hdhr/identity.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Display name shown in client tuner pickers when probing PrismCast's HTTP discovery. Identifies the *manufacturer* of the emulated device, separate from
+ * PrismCast's product identity used in CONFIG.hdhr.friendlyName (which the operator can customize).
+ */
+export declare const HDHR_MANUFACTURER = "PrismCast";
+/**
+ * Hardware model string returned by the UDP control plane for /sys/hwmodel queries. Matches the real HDTC-2US value so clients that filter device lists by
+ * hwmodel ("show only ATSC tuners", "show only Connect-family devices") accept PrismCast.
+ */
+export declare const HDHR_HW_MODEL = "hdhomerun3_atsc";
+/**
+ * Software model string returned by the UDP control plane for /sys/model queries. Identical to the hardware model for the HDTC-2US generation; real Connect
+ * devices report the same string for both keys.
+ */
+export declare const HDHR_MODEL = "hdhomerun3_atsc";
+/**
+ * HDHomeRun CONNECT model identifier returned in /discover.json's ModelNumber field. The CONNECT is an HTTP-streaming model - clients that see this
+ * model expect to tune by HTTP fetching the lineup URL's stream entries, which is exactly how PrismCast serves video.
+ */
+export declare const HDHR_MODEL_NUMBER = "HDTC-2US";
+/**
+ * Firmware family identifier returned in /discover.json's FirmwareName field. The "atsc" suffix matches the hwmodel/model strings; the version is reported
+ * separately as PrismCast's package version so operators can correlate the running PrismCast build with HDHR-aware client tuner pages.
+ */
+export declare const HDHR_FIRMWARE_NAME = "hdhomeruntc_atsc";
+/**
+ * Copyright string returned by the UDP control plane for /sys/copyright queries and matching the prose tools like hdhomerun_config print when probing a
+ * device. Sentence form so the value reads cleanly when surfaced in a status display.
+ */
+export declare const HDHR_COPYRIGHT = "Copyright(C) HJD - PrismCast HDHomeRun emulation.";
+/**
+ * UDP discovery protocol uses a 4-byte device-type tag to classify the device. The single tuner-class value is 0x00000001; PrismCast advertises itself as a
+ * tuner so HDHR-aware clients route to their tuner-handling code paths rather than to repeater or storage paths used by other SiliconDust products.
+ */
+export declare const HDHR_DEVICE_TYPE_TUNER = 1;
+//# sourceMappingURL=identity.d.ts.map

package/dist/hdhr/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../../src/hdhr/identity.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,aAAa,oBAAoB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,UAAU,oBAAgB,CAAC;AAExC;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAAa,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,cAAc,sDAAsD,CAAC;AAElF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,IAAa,CAAC"}

package/dist/hdhr/identity.js

@@ -0,0 +1,51 @@
+/* Copyright(C) 2024-2026, HJD (https://github.com/hjdhjd). All rights reserved.
+ *
+ * identity.ts: HDHomeRun device-identity constants for PrismCast.
+ *
+ * Real HDHomeRun devices identify themselves via a small set of model strings that clients use to gate behavior - "ModelNumber" appears in /discover.json,
+ * "/sys/model" and "/sys/hwmodel" come back over the UDP control plane on port 65001, and "/sys/copyright" is what hdhomerun_config and similar tools print
+ * when probing a device. PrismCast emulates the HDHomeRun CONNECT (an HTTP-streaming model) because the HTTP-streaming family is what every modern HDHR-
+ * aware client expects, and because that model has no DRM context to fake. Two call sites consume these strings: the HTTP discovery endpoints (device.xml,
+ * discover.json) and the UDP Get-request responder (/sys/* keys). This module is the single source of truth so a future model change is a
+ * one-line edit, not a sweep across every consumer.
+ *
+ * The hwmodel/model strings ("hdhomerun3_atsc") assert "ATSC tuner" which PrismCast manifestly is not - but every HDTC-2US in the wild returns this same value
+ * and many clients filter on it. Cohesion with the existing ModelNumber wins over literal accuracy. If a future client gains a "browser tuner" device type the
+ * strings here are the only place that needs to change.
+ */
+/**
+ * Display name shown in client tuner pickers when probing PrismCast's HTTP discovery. Identifies the *manufacturer* of the emulated device, separate from
+ * PrismCast's product identity used in CONFIG.hdhr.friendlyName (which the operator can customize).
+ */
+export const HDHR_MANUFACTURER = "PrismCast";
+/**
+ * Hardware model string returned by the UDP control plane for /sys/hwmodel queries. Matches the real HDTC-2US value so clients that filter device lists by
+ * hwmodel ("show only ATSC tuners", "show only Connect-family devices") accept PrismCast.
+ */
+export const HDHR_HW_MODEL = "hdhomerun3_atsc";
+/**
+ * Software model string returned by the UDP control plane for /sys/model queries. Identical to the hardware model for the HDTC-2US generation; real Connect
+ * devices report the same string for both keys.
+ */
+export const HDHR_MODEL = HDHR_HW_MODEL;
+/**
+ * HDHomeRun CONNECT model identifier returned in /discover.json's ModelNumber field. The CONNECT is an HTTP-streaming model - clients that see this
+ * model expect to tune by HTTP fetching the lineup URL's stream entries, which is exactly how PrismCast serves video.
+ */
+export const HDHR_MODEL_NUMBER = "HDTC-2US";
+/**
+ * Firmware family identifier returned in /discover.json's FirmwareName field. The "atsc" suffix matches the hwmodel/model strings; the version is reported
+ * separately as PrismCast's package version so operators can correlate the running PrismCast build with HDHR-aware client tuner pages.
+ */
+export const HDHR_FIRMWARE_NAME = "hdhomeruntc_atsc";
+/**
+ * Copyright string returned by the UDP control plane for /sys/copyright queries and matching the prose tools like hdhomerun_config print when probing a
+ * device. Sentence form so the value reads cleanly when surfaced in a status display.
+ */
+export const HDHR_COPYRIGHT = "Copyright(C) HJD - PrismCast HDHomeRun emulation.";
+/**
+ * UDP discovery protocol uses a 4-byte device-type tag to classify the device. The single tuner-class value is 0x00000001; PrismCast advertises itself as a
+ * tuner so HDHR-aware clients route to their tuner-handling code paths rather than to repeater or storage paths used by other SiliconDust products.
+ */
+export const HDHR_DEVICE_TYPE_TUNER = 0x00000001;
+//# sourceMappingURL=identity.js.map

package/dist/hdhr/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../../src/hdhr/identity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAE7C;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,iBAAiB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,aAAa,CAAC;AAExC;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,kBAAkB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,mDAAmD,CAAC;AAElF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAC"}

package/dist/hdhr/index.d.ts

@@ -1,9 +1,27 @@
+import type { ChangeOutcome, ConfigChange } from "../config/reactivity.ts";
 /**
- * Starts the HDHomeRun emulation server if enabled in configuration. This includes generating a DeviceID on first run and starting the HTTP server for discovery
- * endpoints. If the configured port is unavailable, HDHR emulation is disabled gracefully.
+ * Brings the HDHomeRun emulation surfaces (HTTP + optional UDP discovery) into line with CONFIG.hdhr. Thin delegator to the controller's reconcile so the boot
+ * path and the live-apply path share one code path. Failures are reported through the reconcile result and logged at the surface layer; boot treats them as
+ * graceful degradation and does not propagate them.
  */
 export declare function startHdhrServer(): Promise<void>;
 /**
- * Stops the HDHomeRun emulation server. Called during graceful shutdown.
+ * Stops the HDHomeRun emulation surfaces and waits for the underlying sockets to fully release. Awaiting close completion matters when the caller intends to
+ * immediately rebind on the same port - skipping the await races the still in-flight async close, since the old listening socket may not yet have released
+ * the port, risking EADDRINUSE on the fresh bind. Safe to call more than once: a second call when nothing is running succeeds as a no-op, and a later
+ * startHdhrServer rebinds cleanly.
  */
-export declare function stopHdhrServer(): void;
+export declare function stopHdhrServer(): Promise<void>;
+/**
+ * Live-applies the subset of a config diff that lives under the "hdhr." prefix. Reconciles the HTTP + UDP surfaces to the new CONFIG.hdhr once (whole desired
+ * state, no per-change ordering to get wrong) and then maps each input change to an outcome from the reconciliation result: surface-driving fields (enabled,
+ * port) report rejected when their surface failed to bind; deviceId and friendlyName are read live by their consumers and always apply; discoveryEnabled reports
+ * rejected only when discovery was requested but failed to bind; an unknown hdhr.* field defers so a future field cannot silently no-op.
+ *
+ * Exported so tests can invoke the dispatch directly with a synthetic diff. Registered with the reactivity primitive at module load (side effect at the bottom
+ * of this file) so production settings saves route here automatically.
+ * @param changes - The subset of the diff whose path begins with "hdhr.".
+ * @returns Per-change outcomes.
+ */
+export declare function applyHdhrConfigChanges(changes: readonly ConfigChange[]): Promise<readonly ChangeOutcome[]>;
+//# sourceMappingURL=index.d.ts.map

package/dist/hdhr/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hdhr/index.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AA0S3E;;;;GAIG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,SAAS,aAAa,EAAE,CAAC,CAyChH"}