@oddin-gg/havik-player 1.2.0 → 1.3.0

package/dist/index.d.cts

@@ -95,7 +95,8 @@ export declare interface CreatePlayerOptions {
      * playback has fallen well behind. Default: true. Live/LL only.
      */
     snapToLiveOnRefocus?: boolean;
-    /** Force an engine; 'auto' picks native HLS on Safari, hls.js elsewhere. Default: 'auto'. */
+    /** Force an engine; 'auto' prefers hls.js wherever supported (incl. modern
+     *  Safari/iOS via ManagedMediaSource) and falls back to native HLS. Default: 'auto'. */
     engine?: 'auto' | 'hls' | 'native';
     /** Optional viewer id (X-User-Id on the license POST). */
     userId?: string;
@@ -186,11 +187,50 @@ export declare type CredentialSource = Credential_2 | (() => Credential_2 | Prom
  */
 export declare function deriveEventsBaseUrl(baseUrl: string): string | undefined;
 
+/**
+ * Probe whether DRM playback can work here. Resolves — never rejects.
+ *
+ * Call it lazily (only for content whose descriptor says `drmEnabled`), CACHE
+ * the result yourself (probes are not memoized, and the EME spec allows each
+ * call to show consent prompts / trigger CDM downloads), and treat
+ * 'supported' as necessary-not-sufficient: the licence server, CORS
+ * onboarding and content packaging still have to cooperate.
+ */
+export declare function detectDrmSupport(opts?: DetectDrmSupportOptions): Promise<DrmSupportResult>;
+
+export declare interface DetectDrmSupportOptions {
+    /** Systems to probe, in order. Default: both. */
+    systems?: DrmSystem[];
+    /** OVERALL budget for the whole call before concluding 'probe-timeout' —
+     *  shared across every probed system/stage, not per probe. Default 5000ms. */
+    timeoutMs?: number;
+}
+
 export declare interface DrmInfo {
     widevine?: WidevineInfo;
     fairplay?: FairPlayInfo;
 }
 
+export declare interface DrmSupportResult {
+    verdict: DrmSupportVerdict;
+    /** The first system that probed as working (when verdict is 'supported'). */
+    system?: DrmSystem;
+    /** Per-system outcome, for diagnostics/support bundles. */
+    detail: Partial<Record<DrmSystem, string>>;
+}
+
+export declare type DrmSupportVerdict = 
+/** At least one probed system produced working MediaKeys. */
+'supported'
+/** EME exists but no probed system yields a CDM (e.g. iOS third-party browsers). */
+| 'no-cdm'
+/** Not a secure context — EME is unavailable by spec (http://<LAN-IP> dev, etc.). */
+| 'insecure-context'
+/** SecurityError: permissions-policy / iframe allow="encrypted-media" missing. */
+| 'blocked-by-policy'
+/** The access promise never settled within timeoutMs (some WebViews). */
+| 'probe-timeout';
+
 export declare type DrmSystem = 'widevine' | 'fairplay';
 
 export declare interface EmbedConfig {

package/dist/index.d.ts

@@ -95,7 +95,8 @@ export declare interface CreatePlayerOptions {
      * playback has fallen well behind. Default: true. Live/LL only.
      */
     snapToLiveOnRefocus?: boolean;
-    /** Force an engine; 'auto' picks native HLS on Safari, hls.js elsewhere. Default: 'auto'. */
+    /** Force an engine; 'auto' prefers hls.js wherever supported (incl. modern
+     *  Safari/iOS via ManagedMediaSource) and falls back to native HLS. Default: 'auto'. */
     engine?: 'auto' | 'hls' | 'native';
     /** Optional viewer id (X-User-Id on the license POST). */
     userId?: string;
@@ -186,11 +187,50 @@ export declare type CredentialSource = Credential_2 | (() => Credential_2 | Prom
  */
 export declare function deriveEventsBaseUrl(baseUrl: string): string | undefined;
 
+/**
+ * Probe whether DRM playback can work here. Resolves — never rejects.
+ *
+ * Call it lazily (only for content whose descriptor says `drmEnabled`), CACHE
+ * the result yourself (probes are not memoized, and the EME spec allows each
+ * call to show consent prompts / trigger CDM downloads), and treat
+ * 'supported' as necessary-not-sufficient: the licence server, CORS
+ * onboarding and content packaging still have to cooperate.
+ */
+export declare function detectDrmSupport(opts?: DetectDrmSupportOptions): Promise<DrmSupportResult>;
+
+export declare interface DetectDrmSupportOptions {
+    /** Systems to probe, in order. Default: both. */
+    systems?: DrmSystem[];
+    /** OVERALL budget for the whole call before concluding 'probe-timeout' —
+     *  shared across every probed system/stage, not per probe. Default 5000ms. */
+    timeoutMs?: number;
+}
+
 export declare interface DrmInfo {
     widevine?: WidevineInfo;
     fairplay?: FairPlayInfo;
 }
 
+export declare interface DrmSupportResult {
+    verdict: DrmSupportVerdict;
+    /** The first system that probed as working (when verdict is 'supported'). */
+    system?: DrmSystem;
+    /** Per-system outcome, for diagnostics/support bundles. */
+    detail: Partial<Record<DrmSystem, string>>;
+}
+
+export declare type DrmSupportVerdict = 
+/** At least one probed system produced working MediaKeys. */
+'supported'
+/** EME exists but no probed system yields a CDM (e.g. iOS third-party browsers). */
+| 'no-cdm'
+/** Not a secure context — EME is unavailable by spec (http://<LAN-IP> dev, etc.). */
+| 'insecure-context'
+/** SecurityError: permissions-policy / iframe allow="encrypted-media" missing. */
+| 'blocked-by-policy'
+/** The access promise never settled within timeoutMs (some WebViews). */
+| 'probe-timeout';
+
 export declare type DrmSystem = 'widevine' | 'fairplay';
 
 export declare interface EmbedConfig {