@codenkay/video-nsgplayer-core 3.0.2 → 3.0.4

package/dist/index.d.cts

@@ -1,5 +1,3 @@
-import Hls, { LoaderStats, LoaderContext, LoaderConfiguration, LoaderCallbacks } from 'hls.js';
-
 /** Player lifecycle states. */
 type PlayerState = "idle" | "loading" | "ready" | "playing" | "paused" | "buffering" | "renewing" | "ended" | "error" | "destroyed";
 type HlsSupportMode = "hls.js" | "native" | "unsupported";
@@ -89,6 +87,11 @@ type ControlsConfig = {
     showLive?: boolean;
     seekCueDurationMs?: number;
     keyboardShortcuts?: boolean;
+    /**
+     * When true, UI chrome persists the last quality choice (by height) in
+     * localStorage and restores it for later sessions.
+     */
+    persistQualityPreference?: boolean;
 };
 type ThemeConfig = {
     playIconPreset?: PlayIconPreset;
@@ -286,7 +289,7 @@ type PlayerEventMap = {
 };
 
 declare const PLAYBACK_RATES: readonly [0.5, 0.75, 1, 1.25, 1.5, 2];
-declare const PACKAGE_VERSION = "3.0.2";
+declare const PACKAGE_VERSION = "3.0.3";
 declare const DEFAULT_PLAYER_BEHAVIOR: Required<PlayerBehaviorConfig>;
 declare const DEFAULT_CONTROLS: Required<ControlsConfig>;
 declare const DEFAULT_THEME: Required<ThemeConfig>;
@@ -654,6 +657,54 @@ declare class RefreshManager {
     private renew;
 }
 
+/**
+ * Local loader types (structurally compatible with hls.js) so the public
+ * `.d.ts` does not require a value import of optional peer `hls.js`.
+ */
+type HlsLoaderTiming = {
+    start: number;
+    first: number;
+    end: number;
+};
+type LoaderStats = {
+    aborted: boolean;
+    loaded: number;
+    retry: number;
+    total: number;
+    chunkCount: number;
+    bwEstimate: number;
+    loading: HlsLoaderTiming;
+    parsing: {
+        start: number;
+        end: number;
+    };
+    buffering: HlsLoaderTiming;
+};
+type LoaderContext = {
+    url: string;
+    responseType?: string;
+    rangeStart?: number;
+    rangeEnd?: number;
+    progressData?: boolean;
+    [key: string]: unknown;
+};
+type LoaderConfiguration = {
+    timeout?: number;
+};
+type LoaderCallbacks<TContext> = {
+    onSuccess: (response: {
+        url: string;
+        data: ArrayBuffer | string;
+        code?: number;
+    }, stats: LoaderStats, context: TContext, networkDetails: unknown) => void;
+    onError: (error: {
+        code: number;
+        text: string;
+    }, context: TContext, networkDetails: unknown, stats: LoaderStats) => void;
+    onTimeout?: (...args: unknown[]) => void;
+    onAbort?: (...args: unknown[]) => void;
+    onProgress?: (...args: unknown[]) => void;
+};
 type HlsLoaderInstance = {
     stats: LoaderStats;
     context: LoaderContext | null;
@@ -663,6 +714,8 @@ type HlsLoaderInstance = {
 };
 /** Constructor shape compatible with `Hls.DefaultConfig.loader`. */
 type HlsLoaderConstructor = new (config: object) => HlsLoaderInstance;
+/** Public alias — pass `hls.js` default export (typed as object at the boundary). */
+type HlsModuleLike = object;
 /** Max same-origin BFF key attempts before the session circuit opens. */
 declare const KEY_PROXY_MAX_FAILURES = 2;
 type AuthParamsLoaderOptions = {
@@ -678,7 +731,7 @@ declare function isEncryptionKeyUrl(rawUrl: string, baseOrigin?: string): boolea
  * engine loaded. Never statically import `XhrLoader` — that can pull a second
  * hls.js copy into the app bundle after npm pack/publish and break key loads.
  */
-declare function resolveBuiltinHlsLoader(HlsClass: typeof Hls): HlsLoaderConstructor;
+declare function resolveBuiltinHlsLoader(HlsModule: HlsModuleLike): HlsLoaderConstructor;
 /**
  * Rewrites an HLS request URL so signed auth query params are present.
  */
@@ -686,7 +739,7 @@ declare function rewriteHlsRequestUrl(rawUrl: string, store: AuthParamsStore, op
 /**
  * hls.js loader: auth query rewrite + enterprise AES key loading.
  */
-declare function createAuthParamsLoader(HlsClass: typeof Hls, store: AuthParamsStore, options?: AuthParamsLoaderOptions): HlsLoaderConstructor;
+declare function createAuthParamsLoader(HlsModule: HlsModuleLike, store: AuthParamsStore, options?: AuthParamsLoaderOptions): HlsLoaderConstructor;
 
 declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>, depth?: number): unknown;
 /**
@@ -695,4 +748,4 @@ declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>
  */
 declare function redactObject(obj: Record<string, unknown>, seen?: WeakSet<object>, depth?: number): Record<string, unknown>;
 
-export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, KEY_PROXY_MAX_FAILURES, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };
+export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsLoaderConstructor, type HlsModuleLike, type HlsQualityLevel, type HlsSupportMode, KEY_PROXY_MAX_FAILURES, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };

package/dist/index.d.ts

@@ -1,5 +1,3 @@
-import Hls, { LoaderStats, LoaderContext, LoaderConfiguration, LoaderCallbacks } from 'hls.js';
-
 /** Player lifecycle states. */
 type PlayerState = "idle" | "loading" | "ready" | "playing" | "paused" | "buffering" | "renewing" | "ended" | "error" | "destroyed";
 type HlsSupportMode = "hls.js" | "native" | "unsupported";
@@ -89,6 +87,11 @@ type ControlsConfig = {
     showLive?: boolean;
     seekCueDurationMs?: number;
     keyboardShortcuts?: boolean;
+    /**
+     * When true, UI chrome persists the last quality choice (by height) in
+     * localStorage and restores it for later sessions.
+     */
+    persistQualityPreference?: boolean;
 };
 type ThemeConfig = {
     playIconPreset?: PlayIconPreset;
@@ -286,7 +289,7 @@ type PlayerEventMap = {
 };
 
 declare const PLAYBACK_RATES: readonly [0.5, 0.75, 1, 1.25, 1.5, 2];
-declare const PACKAGE_VERSION = "3.0.2";
+declare const PACKAGE_VERSION = "3.0.3";
 declare const DEFAULT_PLAYER_BEHAVIOR: Required<PlayerBehaviorConfig>;
 declare const DEFAULT_CONTROLS: Required<ControlsConfig>;
 declare const DEFAULT_THEME: Required<ThemeConfig>;
@@ -654,6 +657,54 @@ declare class RefreshManager {
     private renew;
 }
 
+/**
+ * Local loader types (structurally compatible with hls.js) so the public
+ * `.d.ts` does not require a value import of optional peer `hls.js`.
+ */
+type HlsLoaderTiming = {
+    start: number;
+    first: number;
+    end: number;
+};
+type LoaderStats = {
+    aborted: boolean;
+    loaded: number;
+    retry: number;
+    total: number;
+    chunkCount: number;
+    bwEstimate: number;
+    loading: HlsLoaderTiming;
+    parsing: {
+        start: number;
+        end: number;
+    };
+    buffering: HlsLoaderTiming;
+};
+type LoaderContext = {
+    url: string;
+    responseType?: string;
+    rangeStart?: number;
+    rangeEnd?: number;
+    progressData?: boolean;
+    [key: string]: unknown;
+};
+type LoaderConfiguration = {
+    timeout?: number;
+};
+type LoaderCallbacks<TContext> = {
+    onSuccess: (response: {
+        url: string;
+        data: ArrayBuffer | string;
+        code?: number;
+    }, stats: LoaderStats, context: TContext, networkDetails: unknown) => void;
+    onError: (error: {
+        code: number;
+        text: string;
+    }, context: TContext, networkDetails: unknown, stats: LoaderStats) => void;
+    onTimeout?: (...args: unknown[]) => void;
+    onAbort?: (...args: unknown[]) => void;
+    onProgress?: (...args: unknown[]) => void;
+};
 type HlsLoaderInstance = {
     stats: LoaderStats;
     context: LoaderContext | null;
@@ -663,6 +714,8 @@ type HlsLoaderInstance = {
 };
 /** Constructor shape compatible with `Hls.DefaultConfig.loader`. */
 type HlsLoaderConstructor = new (config: object) => HlsLoaderInstance;
+/** Public alias — pass `hls.js` default export (typed as object at the boundary). */
+type HlsModuleLike = object;
 /** Max same-origin BFF key attempts before the session circuit opens. */
 declare const KEY_PROXY_MAX_FAILURES = 2;
 type AuthParamsLoaderOptions = {
@@ -678,7 +731,7 @@ declare function isEncryptionKeyUrl(rawUrl: string, baseOrigin?: string): boolea
  * engine loaded. Never statically import `XhrLoader` — that can pull a second
  * hls.js copy into the app bundle after npm pack/publish and break key loads.
  */
-declare function resolveBuiltinHlsLoader(HlsClass: typeof Hls): HlsLoaderConstructor;
+declare function resolveBuiltinHlsLoader(HlsModule: HlsModuleLike): HlsLoaderConstructor;
 /**
  * Rewrites an HLS request URL so signed auth query params are present.
  */
@@ -686,7 +739,7 @@ declare function rewriteHlsRequestUrl(rawUrl: string, store: AuthParamsStore, op
 /**
  * hls.js loader: auth query rewrite + enterprise AES key loading.
  */
-declare function createAuthParamsLoader(HlsClass: typeof Hls, store: AuthParamsStore, options?: AuthParamsLoaderOptions): HlsLoaderConstructor;
+declare function createAuthParamsLoader(HlsModule: HlsModuleLike, store: AuthParamsStore, options?: AuthParamsLoaderOptions): HlsLoaderConstructor;
 
 declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>, depth?: number): unknown;
 /**
@@ -695,4 +748,4 @@ declare function redactValue(key: string, value: unknown, seen?: WeakSet<object>
  */
 declare function redactObject(obj: Record<string, unknown>, seen?: WeakSet<object>, depth?: number): Record<string, unknown>;
 
-export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsQualityLevel, type HlsSupportMode, KEY_PROXY_MAX_FAILURES, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };
+export { type AccessibilityConfig, type AnalyticsConfig, type AuthConfig, AuthManager, AuthParamsStore, type AuthToken, type AuthTokenProviderContext, type BufferedRange, type ControlsConfig, type CreateVideoPlayerOptions, DEFAULT_CONTROLS, DEFAULT_LIVE_EDGE_TOLERANCE_SECONDS, DEFAULT_PLAYER_BEHAVIOR, DEFAULT_PLAYER_CONFIG, DEFAULT_THEME, DEFAULT_WATERMARK, type DebugConfig, EventEmitter, type HlsLoaderConstructor, type HlsModuleLike, type HlsQualityLevel, type HlsSupportMode, KEY_PROXY_MAX_FAILURES, type LiveMediaSnapshot, type LoggingConfig, PACKAGE_VERSION, PLAYBACK_RATES, type PlayIconPreset, type PlaybackCredentialConfig, type PlaybackRate, type PlaybackSource, type PlaybackSourceContext, PlaybackSourceManager, type PlayerAudioTrack, type PlayerBehaviorConfig, type PlayerConfig, type PlayerDiagnostics, type PlayerError, PlayerErrorCode, type PlayerEventMap, type PlayerSkipSeconds, type PlayerState, type PlayerTextTrack, type PlayerZoomLevel, type QualitySelection, RefreshManager, SECRET_SCAN_MAX_DEPTH, type SeekToLiveResult, type StreamingConfig, type TextTrackSelection, type ThemeConfig, type VideoPlayer, type WatermarkConfig, assertNoSecretsInConfig, createAuthParamsLoader, createPlayerError, createVideoPlayer, getLiveEdgeTime, isAtLiveEdge, isEncryptionKeyUrl, isPlainObject, mergePlayerConfig, redactObject, redactSensitive, redactValue, resolveBuiltinHlsLoader, rewriteHlsRequestUrl, seekToLiveEdge, themeToCssVars };

package/dist/index.js

@@ -146,7 +146,7 @@ var AuthManager = class {
 
 // src/config/defaults.ts
 var PLAYBACK_RATES = [0.5, 0.75, 1, 1.25, 1.5, 2];
-var PACKAGE_VERSION = "3.0.2";
+var PACKAGE_VERSION = "3.0.3";
 var DEFAULT_PLAYER_BEHAVIOR = {
   autoplay: true,
   startMuted: true,
@@ -170,7 +170,8 @@ var DEFAULT_CONTROLS = {
   showSkip: true,
   showLive: true,
   seekCueDurationMs: 720,
-  keyboardShortcuts: true
+  keyboardShortcuts: true,
+  persistQualityPreference: false
 };
 var DEFAULT_THEME = {
   playIconPreset: "triangle",
@@ -792,7 +793,8 @@ function rememberBuiltin(HlsClass, loader) {
 function getStashedBuiltinLoader(loader) {
   return loader[BUILTIN_LOADER_REF];
 }
-function resolveBuiltinHlsLoader(HlsClass) {
+function resolveBuiltinHlsLoader(HlsModule) {
+  const HlsClass = HlsModule;
   const cached = builtinLoaderByHls.get(HlsClass);
   if (cached) return cached;
   const start = HlsClass.DefaultConfig.loader;
@@ -1023,7 +1025,9 @@ async function loadEncryptionKeyEnterprise(context, callbacks, plan, signal, sta
     );
     return "ok";
   }
-  const needsBearer = Boolean(plan.accessToken) && (queryResult.status === 401 || queryResult.status === 403);
+  const needsBearer = Boolean(plan.accessToken) && (queryResult.status === 401 || queryResult.status === 403 || // Browser-direct: opaque CORS/network on unsigned GET — try Bearer once
+  // Appextech allows ACAO + Authorization (AUTH_MODE=browser, no BFF).
+  queryResult.cors || queryResult.status === 0);
   if (needsBearer && plan.accessToken) {
     const bearerResult = await fetchEncryptionKeyBytes(
       plan.signedKeyUrl,
@@ -1038,7 +1042,7 @@ async function loadEncryptionKeyEnterprise(context, callbacks, plan, signal, sta
       );
       return "ok";
     }
-    if (bearerResult.cors) {
+    if (bearerResult.cors || bearerResult.status === 0) {
       return "try_xhr";
     }
     callbacks.onError(
@@ -1066,7 +1070,8 @@ async function loadEncryptionKeyEnterprise(context, callbacks, plan, signal, sta
   );
   return "ok";
 }
-function createAuthParamsLoader(HlsClass, store, options = {}) {
+function createAuthParamsLoader(HlsModule, store, options = {}) {
+  const HlsClass = HlsModule;
   const BaseLoader = resolveBuiltinHlsLoader(HlsClass);
   rememberBuiltin(HlsClass, BaseLoader);
   const maxProxyFailures = typeof options.keyProxyMaxFailures === "number" && options.keyProxyMaxFailures >= 0 ? options.keyProxyMaxFailures : KEY_PROXY_MAX_FAILURES;
@@ -1276,7 +1281,7 @@ var HlsEngine = class {
         if (!data.fatal) return;
       } else if (!data.fatal) {
         callbacks.onFatalError?.(
-          status ? `Encryption key load failed (HTTP ${status}).` : "Encryption key load failed (network/CORS). Ensure signed query params are applied, or use keyProxyUrlBuilder / getKeyAccessToken when the key host requires API Bearer."
+          status ? `Encryption key load failed (HTTP ${status}).` : "Encryption key load failed (network/CORS). For browser-direct mode the key host must allow CORS (and Authorization if Bearer is required). Otherwise use keyProxyUrlBuilder (same-origin BFF) when the server IP can reach Appextech."
         );
         return;
       }