@nomercy-entertainment/nomercy-video-player 2.2.1 → 2.2.2

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## [Unreleased]
 
+## [2.2.2] — 2026-09-04
+
+### Fixed
+
+- A 404 got the full retry ladder: thirty seconds of spinner on an episode that was never encoded, ending in the generic network error. The file is not late, it is absent, and no amount of waiting changes the answer; 410 is the same answer said more firmly. Both now get no retries and their own code, `core:stream/media-absent`, so a consumer can offer the next item instead of the dead-end overlay it shows for a decode failure. The code matches `CoreErrorCodes.MEDIA_ABSENT` in the Kotlin trio.
+- Georgia's subtitle-font fallback was `sans-serif`. Georgia is a serif face, so a client without it installed — Android carries none — fell back to the one font every other choice already draws, collapsing distinct options into each other.
+
+
 ## [2.2.1] — 2026-09-04
 
 ### Changed

package/dist/adapters/video-backend/html5.js

@@ -6,7 +6,7 @@
 //  SPDX-License-Identifier: Apache-2.0
 // -----------------------------------------------------------------------------
 import { abrCeiling, appendAuthTokenParam, createAuthorizationXhrSetup, destroyHlsInstance, detectDisplayHdr, hdrDecision, isHls, MediaElementBackend, MediaFormatError, mediaFormatError, panePixels, resetMediaElement, sizeAbrCeiling, supportsNativeHls, } from '@nomercy-entertainment/nomercy-player-core';
-import { SOURCE_OUTAGE_BACKOFF_MS, sourceOutageRetryLimit } from './source-outage.js';
+import { isMediaAbsentStatus, MEDIA_ABSENT, SOURCE_OUTAGE_BACKOFF_MS, sourceOutageRetryLimit } from './source-outage.js';
 const CODEC_LABELS = [
     [/avc1|h264/i, 'H.264'],
     [/hvc1|hev1|h265/i, 'H.265 (HEVC)'],
@@ -860,6 +860,15 @@ export class Html5VideoBackend extends MediaElementBackend {
         if (httpStatus === 0)
             this._sawConnectionFailure = true;
         const limit = sourceOutageRetryLimit(httpStatus, this._sawConnectionFailure);
+        // The server answered that this item has no media. Waiting cannot change
+        // that, and a consumer can act on it — offer the next item — but only if
+        // it is told which failure this was, so it gets its own code rather than
+        // the generic network one every outage ends with.
+        if (isMediaAbsentStatus(httpStatus) && !this._sawConnectionFailure) {
+            this._recoveringFromOutage = false;
+            this._escalateHlsError(MEDIA_ABSENT, `media absent (HTTP ${httpStatus}): ${data.details}`);
+            return;
+        }
         if (this._netRetryCount >= limit) {
             // The ladder is spent, but a device that gets a route back later
             // still deserves its session rather than a dead error overlay.

package/dist/adapters/video-backend/source-outage.d.ts

@@ -45,9 +45,26 @@ export declare function sourceOutageBudgetMs(): number;
  * connection-failure-gated budget would cut short.
  */
 export declare function isOriginDownStatus(httpStatus: number): boolean;
+/** No rung at all: the answer will not change by asking again. */
+export declare const NO_RETRIES = 0;
+/**
+ * True for a status that means the server answered, and answered that this
+ * media does not exist.
+ *
+ * An episode that has not been encoded yet answers 404, and it will answer 404
+ * to every retry: the file is not late, it is absent. Waiting is not a strategy
+ * for it, and the viewer is the only one who can decide what to do instead.
+ * 410 is the same answer said more firmly.
+ */
+export declare function isMediaAbsentStatus(httpStatus: number): boolean;
 /**
  * How many rungs this failure is allowed.
  *
+ * A 404 gets NONE. It used to get five, which is thirty seconds of spinner on
+ * an episode that was never encoded, and at the end of it the viewer was told
+ * nothing they could act on. A definite answer is worth surfacing the moment it
+ * arrives, so the consumer can offer to move to the next item.
+ *
  * @param httpStatus - The status the load gave up on, or 0 when the failure
  *   carried no response at all, which is what a refused connection looks like
  *   from a browser.
@@ -56,3 +73,10 @@ export declare function isOriginDownStatus(httpStatus: number): boolean;
  *   from a video that is genuinely gone.
  */
 export declare function sourceOutageRetryLimit(httpStatus: number, sawConnectionFailure: boolean): number;
+/**
+ * The code a consumer reads to offer "skip to the next item" rather than a dead
+ * end. Its Kotlin peer is `CoreErrorCodes.MEDIA_ABSENT`; the two trios must
+ * name this the same failure or a client written against one is wrong on the
+ * other.
+ */
+export declare const MEDIA_ABSENT = "core:stream/media-absent";

package/dist/adapters/video-backend/source-outage.js

@@ -63,9 +63,28 @@ export function isOriginDownStatus(httpStatus) {
         || httpStatus === 503
         || httpStatus === 504;
 }
+/** No rung at all: the answer will not change by asking again. */
+export const NO_RETRIES = 0;
+/**
+ * True for a status that means the server answered, and answered that this
+ * media does not exist.
+ *
+ * An episode that has not been encoded yet answers 404, and it will answer 404
+ * to every retry: the file is not late, it is absent. Waiting is not a strategy
+ * for it, and the viewer is the only one who can decide what to do instead.
+ * 410 is the same answer said more firmly.
+ */
+export function isMediaAbsentStatus(httpStatus) {
+    return httpStatus === 404 || httpStatus === 410;
+}
 /**
  * How many rungs this failure is allowed.
  *
+ * A 404 gets NONE. It used to get five, which is thirty seconds of spinner on
+ * an episode that was never encoded, and at the end of it the viewer was told
+ * nothing they could act on. A definite answer is worth surfacing the moment it
+ * arrives, so the consumer can offer to move to the next item.
+ *
  * @param httpStatus - The status the load gave up on, or 0 when the failure
  *   carried no response at all, which is what a refused connection looks like
  *   from a browser.
@@ -74,11 +93,22 @@ export function isOriginDownStatus(httpStatus) {
  *   from a video that is genuinely gone.
  */
 export function sourceOutageRetryLimit(httpStatus, sawConnectionFailure) {
+    // A connection failure first means the host went away; the 404 that follows
+    // is a route table still warming up, not a missing file.
     if (sawConnectionFailure)
         return SOURCE_OUTAGE_BACKOFF_MS.length;
     if (isOriginDownStatus(httpStatus))
         return SOURCE_OUTAGE_BACKOFF_MS.length;
+    if (isMediaAbsentStatus(httpStatus))
+        return NO_RETRIES;
     if (httpStatus > 0)
         return HTTP_STATUS_RETRY_LIMIT;
     return SOURCE_OUTAGE_BACKOFF_MS.length;
 }
+/**
+ * The code a consumer reads to offer "skip to the next item" rather than a dead
+ * end. Its Kotlin peer is `CoreErrorCodes.MEDIA_ABSENT`; the two trios must
+ * name this the same failure or a client written against one is wrong on the
+ * other.
+ */
+export const MEDIA_ABSENT = 'core:stream/media-absent';