prismcast 1.10.2 → 1.11.0

package/dist/config/channelForm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelForm.d.ts","sourceRoot":"","sources":["../../src/config/channelForm.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAKvE;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAQ7E;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAEhC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAmDD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAaxH;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IAEpC,KAAK,EAAE,YAAY,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,cAAc,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,qBAAqB,CA8CrJ;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CA0BpI"}

package/dist/config/channelForm.js

@@ -2,13 +2,14 @@ import { PREDEFINED_SUFFIX, getServiceGroup, resolvePredefinedVariant } from "./
 import { getChannelEffectiveTags, getEffectiveHdhrEnabled, sortTags } from "./userChannels.js";
 import { isDeepStrictEqual } from "node:util";
 /**
- * Case-insensitive order-independent comparison of two tag arrays. Delegates ordering to sortTags so the case-insensitive locale-aware sort policy lives in
- * exactly one place - this function is about equality, not ordering, and stays out of the "how do we sort tags" decision.
+ * Order-independent equality of two tag arrays. Ordering is delegated to sortTags (case-insensitive locale-aware sort) so that policy lives in exactly one place;
+ * the resulting arrays are then compared for exact, case-sensitive content equality. Only the ordering step is case-insensitive... value equality is case-sensitive,
+ * so ["abc"] and ["ABC"] are not equal here. This function is about equality, not ordering, and stays out of the "how do we sort tags" decision.
  * @param a - The first tag array.
  * @param b - The second tag array.
- * @returns True when the arrays contain the same tags under case-insensitive ordering.
+ * @returns True when the arrays contain the same tags, compared order-independently with case-sensitive value equality.
  */
-function tagsEqual(a, b) {
+export function tagsEqual(a, b) {
     if (a.length !== b.length) {
         return false;
     }
@@ -16,16 +17,17 @@ function tagsEqual(a, b) {
 }
 /* Scalar field list shared by channelMatches and computePredefinedDelta. Keeping these in one const ensures both functions iterate the same field set, so adding
  * a new scalar field to ChannelFormValues requires a single-line addition here and nothing else. The `satisfies` constraint validates every entry is a real key
- * on both Channel (for reads via channelScalar) and ChannelDelta (for writes in computePredefinedDelta), so renaming or removing a field surfaces here at compile
+ * on both ResolvedChannel (for reads via channelScalar) and ChannelDelta (for writes in computePredefinedDelta), so renaming or removing a field surfaces here at compile
  * time rather than silently orphaning the iteration.
  */
 const FORM_SCALAR_FIELDS = [
-    "channelNumber", "channelSelector", "guideTitle", "hdhrEnabled", "logoUrl", "name", "profile", "stationId", "url"
+    "channelNumber", "channelSelector", "forceCapture", "guideTitle", "hdhrEnabled", "logoUrl", "name", "profile", "stationId", "url"
 ];
 /**
  * Reads the comparable value for a scalar form field from a channel record. String fields default to "" when absent (matching the form's empty representation).
- * hdhrEnabled is derived as (value !== false), matching the form's default-true semantics. channelNumber stays number | undefined, matching the form's empty
- * representation. This normalization lets us compare form values against channel records with strict equality.
+ * hdhrEnabled is derived as (value !== false), matching the form's default-true semantics. forceCapture is derived as (value === true), matching its opposite
+ * default-false semantics. channelNumber stays number | undefined, matching the form's empty representation. This normalization lets us compare form values
+ * against channel records with strict equality.
  * @param channel - The channel to read from.
  * @param field - The scalar field name.
  * @returns The comparable value as a boolean, number, string, or undefined.
@@ -35,6 +37,10 @@ function channelScalar(channel, field) {
         case "channelNumber": {
             return channel.channelNumber;
         }
+        case "forceCapture": {
+            // Absent means the channel uses native extraction where it is eligible, so anything other than an explicit true reads as unchecked.
+            return channel.forceCapture === true;
+        }
         case "hdhrEnabled": {
             return getEffectiveHdhrEnabled(channel);
         }
@@ -66,7 +72,8 @@ export function channelMatches(channel, formValues, tags) {
 /**
  * Computes a ChannelDelta representing the difference between submitted form values and the predefined base. Fields that differ from the base are stored in the
  * delta; fields that are cleared (empty string or undefined) are stored as null so the normalizer preserves the explicit clear (absent field means inherit;
- * null means override to "no value"). Tags are compared separately against the base's effective tags and stored as null when cleared.
+ * null means override to "no value"). Tags are compared separately against the base's effective tags and stored as null when cleared. forceCapture is the one
+ * exception to the clearing rule: it stores only its enabled state, and leaving it out of the delta is what turns it off.
  * @param predefinedBase - The canonical predefined channel to diff against.
  * @param formValues - The normalized form values.
  * @param tags - The tag array submitted with the form. Internal comparison via tagsEqual sorts defensively; caller does not need to pre-sort.
@@ -82,14 +89,23 @@ export function computePredefinedDelta(predefinedBase, formValues, tags) {
         if (formValues[field] === channelScalar(predefinedBase, field)) {
             continue;
         }
+        hasChanges = true;
+        /* forceCapture stores only the enabled state and never a clearing null. No catalog entry declares the field, so the comparison base always reads false and
+         * the only way to reach this write is a checked box. Turning it off is expressed by leaving the field out of the delta: every save path through here
+         * replaces the stored entry wholesale, so omission is what clears it. The null-clearing idiom the other fields use matters in PATCH's merge-into-existing
+         * path, which this field deliberately does not join.
+         */
+        if (field === "forceCapture") {
+            deltaWrite[field] = true;
+            continue;
+        }
         const formVal = formValues[field];
         // Empty string or undefined means "clear this field" - store null so the normalizer preserves the explicit clear through the delta model.
         deltaWrite[field] = ((formVal === "") || (formVal === undefined)) ? null : formVal;
-        hasChanges = true;
     }
     // Tags delta: compare against the base's effective (vocabulary-filtered) tags. Using effective tags prevents editing an unrelated field from baking a
-    // vocabulary deletion into the stored delta. sortTags on the stored value mirrors PATCH and transformChannelTags, keeping the storage-order invariant that the
-    // channels normalizer's JSON.stringify equality relies on.
+    // vocabulary deletion into the stored delta. sortTags on the stored value mirrors PATCH and transformChannelTags, keeping the storage order that the channels
+    // normalizer's JSON.stringify equality relies on.
     if (!tagsEqual(tags, getChannelEffectiveTags(predefinedBase))) {
         delta.tags = (tags.length > 0) ? sortTags(tags) : null;
         hasChanges = true;

package/dist/config/channelForm.js.map

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

package/dist/config/consistencyProbe.d.ts

@@ -5,3 +5,4 @@
  * Auto-fix failures are themselves logged but do not propagate. The probe is best-effort hygiene; a failure here must not bring down the server.
  */
 export declare function runConsistencyProbeAtStartup(): Promise<void>;
+//# sourceMappingURL=consistencyProbe.d.ts.map

package/dist/config/consistencyProbe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consistencyProbe.d.ts","sourceRoot":"","sources":["../../src/config/consistencyProbe.ts"],"names":[],"mappings":"AAmKA;;;;;GAKG;AACH,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,IAAI,CAAC,CAgDlE"}

package/dist/config/consistencyProbe.js

@@ -2,29 +2,30 @@
  *
  * consistencyProbe.ts: Cross-store consistency probe for PrismCast persistence.
  *
- * The probe runs once at startup after every initialize* function has loaded its store. It validates "foreign-key-style" invariants that span multiple stores
+ * The probe runs once at startup after every initialize* function has loaded its store. It validates "foreign-key-style" constraints that span multiple stores
  * - things the per-store schema migrations cannot enforce because they only see one file at a time:
  *
- *   - Service selections (in channels.json) reference variants that exist in the rebuilt service group taxonomy.
  *   - Variant entries with a canonicalKey (in channels.json) reference a canonical that exists in PREDEFINED_CHANNELS or the user's stored channels.
- *   - User domain mappings (in profiles.json) reference profiles that exist as built-in or user-defined.
+ *   - User domain mappings (in profiles.json) reference profiles that exist as builtin or user-defined.
  *   - The service tag filter (in config.json's channels.enabledServices) contains only recognized service tags.
  *
  * Each issue is logged loudly and, when an auto-fix is provided, applied immediately. Auto-fixes that need to mutate persistent state go through the same
  * mutate* functions as user code so the integrity validators and snapshot machinery cover them too.
  *
- * Adding a new check is a single function returning ConsistencyIssue[]; collectConsistencyIssues fans out to every check in parallel.
+ * Adding a new check is a single function returning ConsistencyIssue[]; collectConsistencyIssues calls each registered check function and aggregates the
+ * results into one array.
  */
+import { LOG, formatError } from "../utils/index.js";
 import { getAllServiceTags, mutateEnabledServices } from "./services.js";
+import { getUserDomains, getUserProfiles } from "./userProfiles.js";
 import { CONFIG } from "./index.js";
-import { LOG } from "../utils/index.js";
 import { PREDEFINED_CHANNELS } from "../channels/index.js";
 import { getBuiltinProfile } from "./sites.js";
 import { getStoredUserChannels } from "./userChannels.js";
-import { getUserDomains } from "./userProfiles.js";
 /**
- * Validates that every service tag in CONFIG.channels.enabledServices is recognized. Strips and persists unknown tags. Mirrors the runtime cleanup that
- * already happens in initializeUserChannels, but persists the cleanup so the on-disk file no longer carries stale tags between boots.
+ * Validates that every service tag in CONFIG.channels.enabledServices is recognized, and when unknown tags remain its auto-fix persists the cleaned list through
+ * mutateEnabledServices. In practice initializeUserChannels already strips unrecognized tags from the in-memory CONFIG.channels.enabledServices before the probe
+ * runs - a memory-only cleanup that does not rewrite config.json - so the probe usually sees a clean list and the persisting auto-fix does not fire.
  */
 function checkServiceTagFilter() {
     if (CONFIG.channels.enabledServices.length === 0) {
@@ -71,17 +72,20 @@ function checkVariantCanonicals() {
     return issues;
 }
 /**
- * Validates that every user domain mapping references a profile that exists either as a built-in or user-defined profile.
+ * Validates that every user domain mapping references a profile that exists - either a builtin profile (getBuiltinProfile) or a user-defined one (getUserProfiles).
  */
 function checkDomainProfiles() {
     const issues = [];
     const userDomains = getUserDomains();
+    const userProfiles = getUserProfiles();
     for (const [domain, config] of Object.entries(userDomains)) {
         const profileKey = config.profile;
         if (!profileKey) {
             continue;
         }
-        if (getBuiltinProfile(profileKey)) {
+        // A domain mapping may target either a builtin profile or a user-defined one - the save-path validator (validateDomain) accepts both - so we consult both
+        // tables here. Checking only builtins would raise a false "missing profile" warning for a perfectly valid mapping onto a user-created profile.
+        if (getBuiltinProfile(profileKey) || userProfiles[profileKey]) {
             continue;
         }
         issues.push({
@@ -93,7 +97,7 @@ function checkDomainProfiles() {
     return issues;
 }
 /**
- * Aggregates issues from every consistency check. New checks should be added here as additional collector calls.
+ * Aggregates issues from each registered check function. New checks are added here as an additional call in the same list.
  */
 function collectConsistencyIssues() {
     return [
@@ -115,8 +119,8 @@ export async function runConsistencyProbeAtStartup() {
     }
     for (const issue of issues) {
         const message = "Consistency probe (" + issue.category + ", " + issue.severity + "): " + issue.description;
-        // Defensive: no current checker emits severity:"error" - all three checks return "warning" issues. The branch exists so a future check that needs operator
-        // attention rather than auto-cleanup can mark itself error and surface accordingly. Pin via a future test seam if/when an error-severity check is added.
+        // Defensive: no current checker emits severity:"error" - every check returns "warning" issues. The branch exists so a future check that needs operator
+        // attention rather than auto-cleanup can mark itself error and surface accordingly. Add a test to pin this behavior once an error-severity check exists.
         if (issue.severity === "error") {
             LOG.error(message);
         }
@@ -124,15 +128,17 @@ export async function runConsistencyProbeAtStartup() {
             LOG.warn(message);
         }
     }
-    // Run auto-fixes in parallel. Each fix is independent and a failure on one does not block the others.
-    await Promise.all(issues.filter((issue) => (issue.severity === "warning") && issue.autoFix).map(async (issue) => {
-        try {
-            await issue.autoFix?.();
+    // Run auto-fixes in parallel via Promise.allSettled - each fix is independent and a failure on one must not block the others. We iterate the eligible issues
+    // and look up each settlement by index (length-paired by construction; Promise.allSettled preserves input order and arity), logging rejected reasons as
+    // warnings while leaving successful fixes intact.
+    const eligible = issues.filter((issue) => (issue.severity === "warning") && issue.autoFix);
+    const results = await Promise.allSettled(eligible.map(async (issue) => issue.autoFix?.()));
+    for (const [index, issue] of eligible.entries()) {
+        const result = results[index];
+        if (result?.status === "rejected") {
+            LOG.warn("Consistency probe auto-fix failed for %s: %s.", issue.category, formatError(result.reason));
         }
-        catch (error) {
-            LOG.warn("Consistency probe auto-fix failed for %s: %s.", issue.category, (error instanceof Error) ? error.message : String(error));
-        }
-    }));
+    }
     // Defensive: paired with the per-issue severity dispatch above. No checker currently emits severity:"error", so this aggregate report is unreachable today;
     // it remains in place so a future error-severity check produces the operator-visible summary line without any further wiring.
     const errors = issues.filter((issue) => issue.severity === "error").length;

package/dist/config/consistencyProbe.js.map

@@ -1 +1 @@
-{"version":3,"file":"consistencyProbe.js","sourceRoot":"","sources":["../../src/config/consistencyProbe.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consistencyProbe.js","sourceRoot":"","sources":["../../src/config/consistencyProbe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAqB1D;;;;GAIG;AACH,SAAS,qBAAqB;IAE5B,IAAG,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAEhD,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACrE,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,CAAC,GAAG,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC;IAEtD,IAAG,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAExB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,CAAC;YAEN,OAAO,EAAE,KAAK,IAAmB,EAAE;gBAEjC,6GAA6G;gBAC7G,MAAM,qBAAqB,CAAC,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACvE,CAAC;YACD,QAAQ,EAAE,qBAAqB;YAC/B,WAAW,EAAE,+CAA+C,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACjF,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,sBAAsB;IAE7B,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,qBAAqB,EAAE,CAAC;IAEvC,KAAI,MAAM,CAAE,GAAG,EAAE,KAAK,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAEnD,MAAM,YAAY,GAAI,KAAiB,CAAC,YAAY,CAAC;QAErD,IAAG,CAAC,YAAY,EAAE,CAAC;YAEjB,SAAS;QACX,CAAC;QAED,IAAG,mBAAmB,CAAC,YAAY,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAE7D,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YAEV,QAAQ,EAAE,4BAA4B;YACtC,WAAW,EAAE,WAAW,GAAG,GAAG,GAAG,kCAAkC,GAAG,YAAY,GAAG,IAAI;YACzF,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB;IAE1B,MAAM,MAAM,GAAuB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,eAAe,EAAE,CAAC;IAEvC,KAAI,MAAM,CAAE,MAAM,EAAE,MAAM,CAAE,IAAI,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;QAE5D,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;QAElC,IAAG,CAAC,UAAU,EAAE,CAAC;YAEf,SAAS;QACX,CAAC;QAED,0JAA0J;QAC1J,+IAA+I;QAC/I,IAAG,iBAAiB,CAAC,UAAU,CAAC,IAAI,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YAE7D,SAAS;QACX,CAAC;QAED,MAAM,CAAC,IAAI,CAAC;YAEV,QAAQ,EAAE,yBAAyB;YACnC,WAAW,EAAE,UAAU,GAAG,MAAM,GAAG,gCAAgC,GAAG,UAAU,GAAG,IAAI;YACvF,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,wBAAwB;IAE/B,OAAO;QAEL,GAAG,qBAAqB,EAAE;QAC1B,GAAG,sBAAsB,EAAE;QAC3B,GAAG,mBAAmB,EAAE;KACzB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B;IAEhD,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAE1C,IAAG,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAEvB,OAAO;IACT,CAAC;IAED,KAAI,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAE1B,MAAM,OAAO,GAAG,qBAAqB,GAAG,KAAK,CAAC,QAAQ,GAAG,IAAI,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK,GAAG,KAAK,CAAC,WAAW,CAAC;QAE3G,uJAAuJ;QACvJ,yJAAyJ;QACzJ,IAAG,KAAK,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAE9B,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;aAAM,CAAC;YAEN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IAED,6JAA6J;IAC7J,wJAAwJ;IACxJ,kDAAkD;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,KAAK,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC3F,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAE3F,KAAI,MAAM,CAAE,KAAK,EAAE,KAAK,CAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAEjD,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAE9B,IAAG,MAAM,EAAE,MAAM,KAAK,UAAU,EAAE,CAAC;YAEjC,GAAG,CAAC,IAAI,CAAC,+CAA+C,EAAE,KAAK,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;IAED,4JAA4J;IAC5J,8HAA8H;IAC9H,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,MAAM,CAAC;IAE3E,IAAG,MAAM,GAAG,CAAC,EAAE,CAAC;QAEd,GAAG,CAAC,KAAK,CAAC,gEAAgE,EAAE,MAAM,CAAC,CAAC;IACtF,CAAC;AACH,CAAC"}

package/dist/config/health.d.ts

@@ -1,12 +1,24 @@
 import type { Nullable } from "../types/index.ts";
 type HealthStatus = "failed" | "success";
+/**
+ * Authentication status for a domain. "verified" means success evidence exists within the TTL window; "needsLogin" means a confirmed provider auth wall was observed
+ * and the user must sign in. The unknown state is represented by the absence of an entry.
+ */
+export type DomainAuthStatus = "needsLogin" | "verified";
+/**
+ * A domain's authentication state entry.
+ */
+export interface DomainAuthEntry {
+    status: DomainAuthStatus;
+    timestamp: number;
+}
 /**
  * Event payload emitted when channel health or domain auth state changes.
  */
 export interface HealthEvent {
     channelKey: string;
     domain: string;
-    status: HealthStatus;
+    status: HealthStatus | "needsLogin";
     timestamp: number;
 }
 /**
@@ -18,13 +30,20 @@ export interface HealthSnapshot {
         status: HealthStatus;
         timestamp: number;
     }>;
-    domains: Record<string, number>;
+    domains: Record<string, DomainAuthEntry>;
 }
 /**
- * Loads the health state from health.json into memory. Entries older than HEALTH_TTL are pruned during loading. Called once at startup from app.ts. Captures
- * a versioned snapshot of the file before reading so a release-introduced regression has a guaranteed restore point.
+ * Loads the health state from health.json into memory. Expired entries are pruned during loading. Called once at startup from app.ts. Loading is also what arms
+ * persistence - writeHealthState serializes the in-memory maps only once this function has hydrated them from disk.
  */
 export declare function loadHealthState(): Promise<void>;
+/**
+ * Flushes the health state to disk immediately, cancelling any pending debounced write and awaiting the on-disk write. Called during graceful shutdown so the final
+ * health update is durably written even when the process exits inside the FLUSH_DELAY debounce window. Writing unconditionally (rather than only when a debounce is
+ * pending) also drains any in-flight mutation behind the store's serialization queue, guaranteeing the on-disk record matches the final in-memory state.
+ * @returns A promise that resolves when the final health-state write has committed.
+ */
+export declare function flushHealthStateNow(): Promise<void>;
 /**
  * Records a successful tune for a channel. Sets the channel's health to "success" and optionally marks the domain as verified (authenticated). Triggers a debounced
  * flush. The markAuth parameter allows callers to skip domain auth marking when a successful tune does not prove paid access (e.g., Sling Freestream channels succeed
@@ -40,6 +59,19 @@ export declare function markChannelSuccess(channelKey: string, domain: string, m
  * @param domain - The domain to mark as authenticated.
  */
 export declare function markDomainAuth(domain: string): void;
+/**
+ * Records that a domain needs sign-in. Used when a confirmed provider authentication wall is observed during channel discovery. Overwrites any existing entry for
+ * the domain, triggers a debounced flush, and emits a health event with an empty channelKey and the "needsLogin" status.
+ * @param domain - The domain that needs sign-in.
+ */
+export declare function markDomainAuthRequired(domain: string): void;
+/**
+ * Clears a domain's needs-sign-in entry, returning the domain to the unknown state. Used when a non-empty discovery proves the auth wall is gone but the provider's
+ * validation cannot prove paid access (e.g., Sling's free-tier lineup appears without a subscription) - the red state must not outlive the wall it reported, but the
+ * domain has not earned verified either. A no-op unless the domain's current state is needs-sign-in: verified entries are never deleted by unproven-access evidence.
+ * @param domain - The domain whose needs-sign-in entry should be cleared.
+ */
+export declare function clearDomainAuthRequirement(domain: string): void;
 /**
  * Records a failed tune for a channel. Sets the channel's health to "failed". Does not affect domain auth - a single channel failure doesn't prove the domain is
  * unauthenticated. Triggers a debounced flush.
@@ -59,12 +91,12 @@ export declare function getChannelHealth(channelKey: string, domain: string): Nu
     timestamp: number;
 }>;
 /**
- * Returns the timestamp when a domain was last verified as authenticated, or null if unknown. Verification is proven by at least one successful tune within the TTL
- * window. A non-null return means the domain is verified; the value is the Unix millisecond timestamp of the most recent successful tune.
+ * Returns a domain's authentication state entry, or null when the domain is unknown (no entry, or a verified entry older than the TTL). Needs-sign-in entries are
+ * exempt from the TTL per the module's status-aware expiry rule.
  * @param domain - The domain to check.
- * @returns Timestamp of last verification, or null if unknown (no entry or stale).
+ * @returns The domain's auth entry, or null if unknown.
  */
-export declare function getDomainAuth(domain: string): Nullable<number>;
+export declare function getDomainAuthState(domain: string): Nullable<DomainAuthEntry>;
 /**
  * Returns a snapshot of current health state for SSE initial payloads. Stale entries (older than HEALTH_TTL) are excluded.
  * @returns Snapshot with channel health and domain auth maps.
@@ -77,3 +109,4 @@ export declare function getHealthSnapshot(): HealthSnapshot;
  */
 export declare function subscribeToHealth(callback: (event: HealthEvent) => void): () => void;
 export {};
+//# sourceMappingURL=health.d.ts.map

package/dist/config/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/config/health.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AA+BlD,KAAK,YAAY,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,UAAU,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,eAAe;IAG9B,MAAM,EAAE,gBAAgB,CAAC;IAGzB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4BD;;GAEG;AACH,MAAM,WAAW,WAAW;IAE1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAE7B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,YAAY,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC1C;AA0KD;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CA0CrD;AAsDD;;;;;GAKG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBzD;AAgCD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,UAAO,GAAG,IAAI,CAgB5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAGnD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ3D;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAAE,MAAM,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAyB1H;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,eAAe,CAAC,CAmB5E;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAoBlD;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,GAAG,MAAM,IAAI,CAUpF"}